<!doctype html>
<html lang="zh-cn" dir="ltr">
 <head> 
  <meta charset="UTF-8"> 
  <title>摇一摇红包 - 微信公众平台开发者文档</title> 
  <meta name="generator" content="MediaWiki 1.17.0"> 
  <link rel="shortcut icon" href="../static/assets/b6e57135e9c7167976dba80b3b09b546.jpg"> 
  <link rel="search" type="application/opensearchdescription+xml" href="../7/62453c80507e836458b441eae4358bdf.html" title="微信公众平台开发者文档 (zh-cn)"> 
  <link rel="alternate" type="application/atom+xml" title="微信公众平台开发者文档的Atom订阅" href="../0/594277f21545345653eb965322ac4b04.html"> 
  <link rel="stylesheet" href="../static/02da6b362196e50cd396d4117c7fa3ea.css"> 
  <meta name="keywords" content="微信公众平台开发者文档,微信小店接口,设备功能接口,Weixin JS接口,分组管理接口">
  <meta name="description" content="公众平台是为微信用户提供服务的平台，而公众平台开发接口则是提供服务的基础，开发者在公众平台网站中创建公众号、获取接口权限后，可以通过阅读本接口文档来帮助开发。">
  <meta name="ResourceLoaderDynamicStyles" content=""> 
  <!--[if lt IE 7]><style type="text/css">body{behavior:url("/wiki/skins/vector/csshover.min.htc")}</style><![endif]-->
 </head> 
 <body class="mediawiki ltr ns-0 ns-subject page-摇一摇红包 skin-vector"> 
  <!--网站头部--> 
  <script type="text/javascript" src="../static/021402488e80774f4bae632d50abd818.js"></script> 
  <script>
	function parseURL(){
		var res = {}, search = location.search;
		if (search.indexOf("?") != 0){
			return res;
		}
		search = search.substr(1).split("&");
		for (var i = 0; i < search.length; ++i){
			var 
				item = search[i],
				idx = item.indexOf("="),
				k = item.substr(0, idx),
				v = item.substr(idx+1);
			res[k] = v;
		}
		return res;
	}

	var params = parseURL();
	$(function(){
		$(".portal").each(function(){
			var portal = $(this), as = portal.find('a');

			as.each(function(){
				var a = $(this), title = a.html();

				if (decodeURIComponent(title) == decodeURIComponent(params['title'])){
					portal.addClass("active").find(".body").show();
					a.addClass("selected");
				}
			});
		})
	});
</script> 
  <div class="headWrap"> 
   <div class="header" id="header"> 
    <div class="inner"> 
     <a class="logo" href="../home/index.html"><img src="../static/assets/dc5de672083b2ec495408b00b96c9aab.png" alt="微信公众平台开发者文档"></a> 
    </div> 
   </div> 
  </div>  
  <script type="text/javascript" src="../static/2ef2bdf6ac1839ee639cb15463231282.js"></script> 
  <!--[if IE 6]>
<style type="text/css">
html{background-image:url(about:blank);background-attachment:fixed;}
#content{overflow-x:hidden;}
.bottomnav{position:absolute;top:expression(eval(document.documentElement.scrollTop+document.documentElement.clientHeight-30));}
</style>
<![endif]--> 
  <!--网站头部--> 
  <div id="mw-page-base" class="noprint"></div> 
  <div id="mw-head-base" class="noprint"></div> 
  <div class="mainwrapper"> 
   <div class="inner"> 
    <!-- panel --> 
    <div id="mw-panel" class="noprint"> 
     <!-- 
						<div id="p-logo"><a style="background-image: url(/wiki/skins/common/images/logo.jpg);" href="/wiki/index.php?title=%E9%A6%96%E9%A1%B5"  title="访问首页"></a></div>
					
					<form class="searchform">
						<input type="text"   name="search" placeholder="搜索关键字 [alt-s]" accesskey="s" class="searchform_text"/>
						<input type="submit" name="fulltext" value="搜索" title="搜索该文字的页面" class="searchform_btn"/>
					</form>
					 --> 
     <!-- 开始前必读 --> 
     <div class="portal" id="p-.E5.BC.80.E5.A7.8B.E5.89.8D.E5.BF.85.E8.AF.BB"> 
      <h5><span class="portal_arrow"></span>开始前必读</h5> 
      <div class="body"> 
       <ul> 
        <li id="n-.E6.9B.B4.E6.96.B0.E6.97.A5.E5.BF.97"><a href="../0/4c93e31f953f24a42b921d2ae8d4e5e0.html">更新日志</a></li> 
        <li id="n-.E5.BC.80.E5.8F.91.E8.80.85.E8.A7.84.E8.8C.83"><a href="../16/52e198333f5c127ddd5c45e875191b14.html">开发者规范</a></li> 
        <li id="n-.E5.85.AC.E4.BC.97.E5.8F.B7.E6.8E.A5.E5.8F.A3.E6.9D.83.E9.99.90.E8.AF.B4.E6.98.8E"><a href="../13/8d4957b72037e3308a0ca1b21f25ae8d.html">公众号接口权限说明</a></li> 
        <li id="n-.E6.8E.A5.E5.8F.A3.E9.A2.91.E7.8E.87.E9.99.90.E5.88.B6.E8.AF.B4.E6.98.8E"><a href="../7/85eff372c164ddc66c47777dc972279f.html">接口频率限制说明</a></li> 
        <li id="n-.E6.8E.A5.E5.8F.A3.E8.BF.94.E5.9B.9E.E7.A0.81.E8.AF.B4.E6.98.8E"><a href="../10/6380dc743053a91c544ffd2b7c959166.html">接口返回码说明</a></li> 
       </ul> 
      </div> 
     </div> 
     <!-- /开始前必读 --> 
     <!-- 开始开发 --> 
     <div class="portal" id="p-.E5.BC.80.E5.A7.8B.E5.BC.80.E5.8F.91"> 
      <h5><span class="portal_arrow"></span>开始开发</h5> 
      <div class="body"> 
       <ul> 
        <li id="n-.E6.8E.A5.E5.85.A5.E6.8C.87.E5.8D.97"><a href="../8/f9a0b8382e0b77d87b3bcc1ce6fbc104.html">接入指南</a></li> 
        <li id="n-.E8.8E.B7.E5.8F.96.E6.8E.A5.E5.8F.A3.E8.B0.83.E7.94.A8.E5.87.AD.E6.8D.AE"><a href="../14/9f9c82c1af308e3b14ba9b973f99a8ba.html">获取接口调用凭据</a></li> 
        <li id="n-.E8.8E.B7.E5.8F.96.E5.BE.AE.E4.BF.A1.E6.9C.8D.E5.8A.A1.E5.99.A8IP.E5.9C.B0.E5.9D.80"><a href="../4/41ef0843d6e108cf6b5649480207561c.html">获取微信服务器IP地址</a></li> 
        <li id="n-.E6.8A.A5.E8.AD.A6.E6.8E.92.E6.9F.A5.E6.8C.87.E5.BC.95"><a href="../7/c478375fae59150b26def82ec061f43b.html">报警排查指引</a></li> 
        <li id="n-.E6.8E.A5.E5.8F.A3.E6.B5.8B.E8.AF.95.E5.8F.B7.E7.94.B3.E8.AF.B7"><a href="http://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=sandbox/login">接口测试号申请</a></li> 
        <li id="n-.E6.8E.A5.E5.8F.A3.E5.9C.A8.E7.BA.BF.E8.B0.83.E8.AF.95"><a href="http://mp.weixin.qq.com/debug/">接口在线调试</a></li> 
        <li id="n-.E5.B8.B8.E8.A7.81.E9.97.AE.E9.A2.98"><a href="http://mp.weixin.qq.com/qa">常见问题</a></li> 
       </ul> 
      </div> 
     </div> 
     <!-- /开始开发 --> 
     <!-- 自定义菜单 --> 
     <div class="portal" id="p-.E8.87.AA.E5.AE.9A.E4.B9.89.E8.8F.9C.E5.8D.95"> 
      <h5><span class="portal_arrow"></span>自定义菜单</h5> 
      <div class="body"> 
       <ul> 
        <li id="n-.E8.87.AA.E5.AE.9A.E4.B9.89.E8.8F.9C.E5.8D.95.E5.88.9B.E5.BB.BA.E6.8E.A5.E5.8F.A3"><a href="../10/0234e39a2025342c17a7d23595c6b40a.html">自定义菜单创建接口</a></li> 
        <li id="n-.E8.87.AA.E5.AE.9A.E4.B9.89.E8.8F.9C.E5.8D.95.E6.9F.A5.E8.AF.A2.E6.8E.A5.E5.8F.A3"><a href="../5/f287d1a5b78a35a8884326312ac3e4ed.html">自定义菜单查询接口</a></li> 
        <li id="n-.E8.87.AA.E5.AE.9A.E4.B9.89.E8.8F.9C.E5.8D.95.E5.88.A0.E9.99.A4.E6.8E.A5.E5.8F.A3"><a href="../3/de21624f2d0d3dafde085dafaa226743.html">自定义菜单删除接口</a></li> 
        <li id="n-.E8.87.AA.E5.AE.9A.E4.B9.89.E8.8F.9C.E5.8D.95.E4.BA.8B.E4.BB.B6.E6.8E.A8.E9.80.81"><a href="../19/a037750e2df0261ab0a84899d16abd33.html">自定义菜单事件推送</a></li> 
        <li id="n-.E4.B8.AA.E6.80.A7.E5.8C.96.E8.8F.9C.E5.8D.95.E6.8E.A5.E5.8F.A3"><a href="../0/c48ccd12b69ae023159b4bfaa7c39c20.html">个性化菜单接口</a></li> 
        <li id="n-.E8.8E.B7.E5.8F.96.E5.85.AC.E4.BC.97.E5.8F.B7.E7.9A.84.E8.8F.9C.E5.8D.95.E9.85.8D.E7.BD.AE"><a href="../14/293d0cb8de95e916d1216a33fcb81fd6.html">获取公众号的菜单配置</a></li> 
       </ul> 
      </div> 
     </div> 
     <!-- /自定义菜单 --> 
     <!-- 消息管理 --> 
     <div class="portal" id="p-.E6.B6.88.E6.81.AF.E7.AE.A1.E7.90.86"> 
      <h5><span class="portal_arrow"></span>消息管理</h5> 
      <div class="body"> 
       <ul> 
        <li id="n-.E6.8E.A5.E6.94.B6.E6.B6.88.E6.81.AF-.E6.8E.A5.E6.94.B6.E6.99.AE.E9.80.9A.E6.B6.88.E6.81.AF"><a href="../17/f298879f8fb29ab98b2f2971d42552fd.html">接收消息-接收普通消息</a></li> 
        <li id="n-.E6.8E.A5.E6.94.B6.E6.B6.88.E6.81.AF-.E6.8E.A5.E6.94.B6.E4.BA.8B.E4.BB.B6.E6.8E.A8.E9.80.81"><a href="../7/9f89d962eba4c5924ed95b513ba69d9b.html">接收消息-接收事件推送</a></li> 
        <li id="n-.E5.8F.91.E9.80.81.E6.B6.88.E6.81.AF-.E8.A2.AB.E5.8A.A8.E5.9B.9E.E5.A4.8D.E6.B6.88.E6.81.AF"><a href="../1/6239b44c206cab9145b1d52c67e6c551.html">发送消息-被动回复消息</a></li> 
        <li id="n-.E5.8F.91.E9.80.81.E6.B6.88.E6.81.AF-.E8.A2.AB.E5.8A.A8.E5.9B.9E.E5.A4.8D.E6.97.B6.E7.9A.84.E5.8A.A0.E8.A7.A3.E5.AF.86"><a href="../14/70e73cedf9fd958d2e23264ba9333ad2.html">发送消息-被动回复时的加解密</a></li> 
        <li id="n-.E5.8F.91.E9.80.81.E6.B6.88.E6.81.AF-.E5.AE.A2.E6.9C.8D.E6.B6.88.E6.81.AF"><a href="../11/c88c270ae8935291626538f9c64bd123.html">发送消息-客服消息</a></li> 
        <li id="n-.E5.8F.91.E9.80.81.E6.B6.88.E6.81.AF-.E7.BE.A4.E5.8F.91.E6.8E.A5.E5.8F.A3"><a href="../15/40b6865b893947b764e2de8e4a1fb55f.html">发送消息-群发接口</a></li> 
        <li id="n-.E5.8F.91.E9.80.81.E6.B6.88.E6.81.AF-.E6.A8.A1.E6.9D.BF.E6.B6.88.E6.81.AF.E6.8E.A5.E5.8F.A3"><a href="../5/6dde9eaa909f83354e0094dc3ad99e05.html">发送消息-模板消息接口</a></li> 
        <li id="n-.E5.8F.91.E9.80.81.E6.B6.88.E6.81.AF-.E6.A8.A1.E6.9D.BF.E6.B6.88.E6.81.AF.E8.BF.90.E8.90.A5.E8.A7.84.E8.8C.83"><a href="../18/8ecd0dfc9acafb2ed86ac3ae8f7c69aa.html">发送消息-模板消息运营规范</a></li> 
        <li id="n-.E8.8E.B7.E5.8F.96.E5.85.AC.E4.BC.97.E5.8F.B7.E8.87.AA.E5.8A.A8.E5.9B.9E.E5.A4.8D.E9.85.8D.E7.BD.AE"><a href="../8/806878e1fc2b9e9aa618ae33896b04c4.html">获取公众号自动回复配置</a></li> 
       </ul> 
      </div> 
     </div> 
     <!-- /消息管理 --> 
     <!-- 微信网页开发 --> 
     <div class="portal" id="p-.E5.BE.AE.E4.BF.A1.E7.BD.91.E9.A1.B5.E5.BC.80.E5.8F.91"> 
      <h5><span class="portal_arrow"></span>微信网页开发</h5> 
      <div class="body"> 
       <ul> 
        <li id="n-.E5.BE.AE.E4.BF.A1.E7.BD.91.E9.A1.B5.E6.8E.88.E6.9D.83"><a href="../4/9ac2e7b1f1d22e9e57260f6553822520.html">微信网页授权</a></li> 
        <li id="n-.E5.BE.AE.E4.BF.A1.E7.BD.91.E9.A1.B5.E5.BC.80.E5.8F.91.E6.A0.B7.E5.BC.8F.E5.BA.93"><a href="../2/ae9782fb42e47ad79eb7b361c2149d16.html">微信网页开发样式库</a></li> 
        <li id="n-.E5.BE.AE.E4.BF.A1JS-SDK"><a href="../11/74ad127cc054f6b80759c40f77ec03db.html">微信JS-SDK</a></li> 
        <li id="n-.E5.BE.AE.E4.BF.A1Web.E5.BC.80.E5.8F.91.E8.80.85.E5.B7.A5.E5.85.B7"><a href="../10/e5f772f4521da17fa0d7304f68b97d7e.html">微信Web开发者工具</a></li> 
       </ul> 
      </div> 
     </div> 
     <!-- /微信网页开发 --> 
     <!-- 素材管理 --> 
     <div class="portal" id="p-.E7.B4.A0.E6.9D.90.E7.AE.A1.E7.90.86"> 
      <h5><span class="portal_arrow"></span>素材管理</h5> 
      <div class="body"> 
       <ul> 
        <li id="n-.E6.96.B0.E5.A2.9E.E4.B8.B4.E6.97.B6.E7.B4.A0.E6.9D.90"><a href="../15/2d353966323806a202cd2deaafe8e557.html">新增临时素材</a></li> 
        <li id="n-.E8.8E.B7.E5.8F.96.E4.B8.B4.E6.97.B6.E7.B4.A0.E6.9D.90"><a href="../9/677a85e3f3849af35de54bb5516c2521.html">获取临时素材</a></li> 
        <li id="n-.E6.96.B0.E5.A2.9E.E6.B0.B8.E4.B9.85.E7.B4.A0.E6.9D.90"><a href="../10/10ea5a44870f53d79449290dfd43d006.html">新增永久素材</a></li> 
        <li id="n-.E8.8E.B7.E5.8F.96.E6.B0.B8.E4.B9.85.E7.B4.A0.E6.9D.90"><a href="../12/3c12fac7c14cb4d0e0d4fe2fbc87b638.html">获取永久素材</a></li> 
        <li id="n-.E5.88.A0.E9.99.A4.E6.B0.B8.E4.B9.85.E7.B4.A0.E6.9D.90"><a href="../7/2212203f4e17253b9aef77dc788f5337.html">删除永久素材</a></li> 
        <li id="n-.E4.BF.AE.E6.94.B9.E6.B0.B8.E4.B9.85.E5.9B.BE.E6.96.87.E7.B4.A0.E6.9D.90"><a href="../10/c7bad9a463db20ff8ccefeedeef51f9e.html">修改永久图文素材</a></li> 
        <li id="n-.E8.8E.B7.E5.8F.96.E7.B4.A0.E6.9D.90.E6.80.BB.E6.95.B0"><a href="../5/a641fd7b5db7a6a946ebebe2ac166885.html">获取素材总数</a></li> 
        <li id="n-.E8.8E.B7.E5.8F.96.E7.B4.A0.E6.9D.90.E5.88.97.E8.A1.A8"><a href="../15/8386c11b7bc4cdd1499c572bfe2e95b3.html">获取素材列表</a></li> 
       </ul> 
      </div> 
     </div> 
     <!-- /素材管理 --> 
     <!-- 用户管理 --> 
     <div class="portal" id="p-.E7.94.A8.E6.88.B7.E7.AE.A1.E7.90.86"> 
      <h5><span class="portal_arrow"></span>用户管理</h5> 
      <div class="body"> 
       <ul> 
        <li id="n-.E7.94.A8.E6.88.B7.E5.88.86.E7.BB.84.E7.AE.A1.E7.90.86"><a href="../8/d6d33cf60bce2a2e4fb10a21be9591b8.html">用户分组管理</a></li> 
        <li id="n-.E8.AE.BE.E7.BD.AE.E7.94.A8.E6.88.B7.E5.A4.87.E6.B3.A8.E5.90.8D"><a href="../16/528098c4a6a87b05120a7665c8db0460.html">设置用户备注名</a></li> 
        <li id="n-.E8.8E.B7.E5.8F.96.E7.94.A8.E6.88.B7.E5.9F.BA.E6.9C.AC.E4.BF.A1.E6.81.AF.28UnionID.E6.9C.BA.E5.88.B6.29"><a href="../1/8a5ce6257f1d3b2afb20f83e72b72ce9.html">获取用户基本信息(UnionID机制)</a></li> 
        <li id="n-.E8.8E.B7.E5.8F.96.E7.94.A8.E6.88.B7.E5.88.97.E8.A1.A8"><a href="../12/54773ff6da7b8bdc95b7d2667d84b1d4.html">获取用户列表</a></li> 
        <li id="n-.E8.8E.B7.E5.8F.96.E7.94.A8.E6.88.B7.E5.9C.B0.E7.90.86.E4.BD.8D.E7.BD.AE"><a href="../4/0bd25e04332eccf83bc2e71df9d3e860.html">获取用户地理位置</a></li> 
       </ul> 
      </div> 
     </div> 
     <!-- /用户管理 --> 
     <!-- 帐号管理 --> 
     <div class="portal" id="p-.E5.B8.90.E5.8F.B7.E7.AE.A1.E7.90.86"> 
      <h5><span class="portal_arrow"></span>帐号管理</h5> 
      <div class="body"> 
       <ul> 
        <li id="n-.E7.94.9F.E6.88.90.E5.B8.A6.E5.8F.82.E6.95.B0.E7.9A.84.E4.BA.8C.E7.BB.B4.E7.A0.81"><a href="../18/167e7d94df85d8389df6c94a7a8f78ba.html">生成带参数的二维码</a></li> 
        <li id="n-.E9.95.BF.E9.93.BE.E6.8E.A5.E8.BD.AC.E7.9F.AD.E9.93.BE.E6.8E.A5.E6.8E.A5.E5.8F.A3"><a href="../6/856aaeb492026466277ea39233dc23ee.html">长链接转短链接接口</a></li> 
        <li id="n-.E5.BE.AE.E4.BF.A1.E8.AE.A4.E8.AF.81.E4.BA.8B.E4.BB.B6.E6.8E.A8.E9.80.81"><a href="../10/2adfb2f10828e87aa1e5c3ef83b17906.html">微信认证事件推送</a></li> 
       </ul> 
      </div> 
     </div> 
     <!-- /帐号管理 --> 
     <!-- 数据统计 --> 
     <div class="portal" id="p-.E6.95.B0.E6.8D.AE.E7.BB.9F.E8.AE.A1"> 
      <h5><span class="portal_arrow"></span>数据统计</h5> 
      <div class="body"> 
       <ul> 
        <li id="n-.E7.94.A8.E6.88.B7.E5.88.86.E6.9E.90.E6.95.B0.E6.8D.AE.E6.8E.A5.E5.8F.A3"><a href="../15/88726a421bfc54654a3095821c3ca3bb.html">用户分析数据接口</a></li> 
        <li id="n-.E5.9B.BE.E6.96.87.E5.88.86.E6.9E.90.E6.95.B0.E6.8D.AE.E6.8E.A5.E5.8F.A3"><a href="../9/d347c6ddb6f86ab11ec3b41c2729c8d9.html">图文分析数据接口</a></li> 
        <li id="n-.E6.B6.88.E6.81.AF.E5.88.86.E6.9E.90.E6.95.B0.E6.8D.AE.E6.8E.A5.E5.8F.A3"><a href="../10/b29e8ca8bf1b0dce033ccb70273f90fa.html">消息分析数据接口</a></li> 
        <li id="n-.E6.8E.A5.E5.8F.A3.E5.88.86.E6.9E.90.E6.95.B0.E6.8D.AE.E6.8E.A5.E5.8F.A3"><a href="../17/252a976f20bd3062af3f03a45f30cff9.html">接口分析数据接口</a></li> 
       </ul> 
      </div> 
     </div> 
     <!-- /数据统计 --> 
     <!-- 微信小店 --> 
     <div class="portal" id="p-.E5.BE.AE.E4.BF.A1.E5.B0.8F.E5.BA.97"> 
      <h5><span class="portal_arrow"></span>微信小店</h5> 
      <div class="body"> 
       <ul> 
        <li id="n-.E5.BE.AE.E4.BF.A1.E5.B0.8F.E5.BA.97.E6.8E.A5.E5.8F.A3"><a href="../6/ae98ac4a7219405153cedc9dddccacca.html">微信小店接口</a></li> 
       </ul> 
      </div> 
     </div> 
     <!-- /微信小店 --> 
     <!-- 微信卡券 --> 
     <div class="portal" id="p-.E5.BE.AE.E4.BF.A1.E5.8D.A1.E5.88.B8"> 
      <h5><span class="portal_arrow"></span>微信卡券</h5> 
      <div class="body"> 
       <ul> 
        <li id="n-.E5.BE.AE.E4.BF.A1.E5.8D.A1.E5.88.B8.E6.8E.A5.E5.8F.A3.E8.AF.B4.E6.98.8E"><a href="../10/597cb57750f375a4b37e2536fd3331ea.html">微信卡券接口说明</a></li> 
        <li id="n-.E5.88.9B.E5.BB.BA.E5.8D.A1.E5.88.B8"><a href="../15/e33671f4ef511b77755142b37502928f.html">创建卡券</a></li> 
        <li id="n-.E6.8A.95.E6.94.BE.E5.8D.A1.E5.88.B8"><a href="../5/f942979ef2f0d313d4d36e3a26766a3d.html">投放卡券</a></li> 
        <li id="n-.E6.A0.B8.E9.94.80.E5.8D.A1.E5.88.B8"><a href="../15/bdfd0c3c6c3b0629e8a425936a973d8b.html">核销卡券</a></li> 
        <li id="n-.E7.AE.A1.E7.90.86.E5.8D.A1.E5.88.B8"><a href="../14/8dd77aeaee85f922db5f8aa6386d385e.html">管理卡券</a></li> 
        <li id="n-.E5.8D.A1.E5.88.B8.E4.BA.8B.E4.BB.B6.E6.8E.A8.E9.80.81"><a href="../16/28b34ee91675a04cb24853768debded4.html">卡券事件推送</a></li> 
        <li id="n-.E6.9C.8B.E5.8F.8B.E7.9A.84.E5.88.B8.E4.B8.93.E5.8C.BA"><a href="../10/333958907c5aae0581e93a24f2df8562.html">朋友的券专区</a></li> 
        <li id="n-.E4.BC.9A.E5.91.98.E5.8D.A1.E4.B8.93.E5.8C.BA"><a href="../15/de148cc4b5190c80002eaf4f6f26c717.html">会员卡专区</a></li> 
        <li id="n-.E7.89.B9.E6.AE.8A.E7.A5.A8.E5.88.B8"><a href="../11/a42da6431597edff7caeaf5d33fac37b.html">特殊票券</a></li> 
        <li id="n-.E7.AC.AC.E4.B8.89.E6.96.B9.E4.BB.A3.E5.88.B6.E4.B8.93.E5.8C.BA"><a href="../13/a1b2bedbca3990108195f13bd7e27401.html">第三方代制专区</a></li> 
        <li id="n-.E5.8D.A1.E5.88.B8.E9.94.99.E8.AF.AF.E7.A0.81"><a href="../7/981e7a73e2bca37a3d1c83f071be6947.html">卡券错误码</a></li> 
       </ul> 
      </div> 
     </div> 
     <!-- /微信卡券 --> 
     <!-- 微信门店 --> 
     <div class="portal" id="p-.E5.BE.AE.E4.BF.A1.E9.97.A8.E5.BA.97"> 
      <h5><span class="portal_arrow"></span>微信门店</h5> 
      <div class="body"> 
       <ul> 
        <li id="n-.E5.BE.AE.E4.BF.A1.E9.97.A8.E5.BA.97.E6.8E.A5.E5.8F.A3"><a href="../11/081986f089826bf94393bef9bf287b8b.html">微信门店接口</a></li> 
       </ul> 
      </div> 
     </div> 
     <!-- /微信门店 --> 
     <!-- 微信智能接口 --> 
     <div class="portal" id="p-.E5.BE.AE.E4.BF.A1.E6.99.BA.E8.83.BD.E6.8E.A5.E5.8F.A3"> 
      <h5><span class="portal_arrow"></span>微信智能接口</h5> 
      <div class="body"> 
       <ul> 
        <li id="n-.E8.AF.AD.E4.B9.89.E7.90.86.E8.A7.A3.E6.8E.A5.E5.8F.A3"><a href="../10/65eb7a43f078cc609cf08dae6805f4a6.html">语义理解接口</a></li> 
       </ul> 
      </div> 
     </div> 
     <!-- /微信智能接口 --> 
     <!-- 微信设备功能 --> 
     <div class="portal" id="p-.E5.BE.AE.E4.BF.A1.E8.AE.BE.E5.A4.87.E5.8A.9F.E8.83.BD"> 
      <h5><span class="portal_arrow"></span>微信设备功能</h5> 
      <div class="body"> 
       <ul> 
        <li id="n-.E8.AE.BE.E5.A4.87.E5.8A.9F.E8.83.BD.E4.BB.8B.E7.BB.8D"><a href="../2/77400d13dc7fca83181bc9806d55b6ce.html">设备功能介绍</a></li> 
       </ul> 
      </div> 
     </div> 
     <!-- /微信设备功能 --> 
     <!-- 微信多客服功能 --> 
     <div class="portal" id="p-.E5.BE.AE.E4.BF.A1.E5.A4.9A.E5.AE.A2.E6.9C.8D.E5.8A.9F.E8.83.BD"> 
      <h5><span class="portal_arrow"></span>微信多客服功能</h5> 
      <div class="body"> 
       <ul> 
        <li id="n-.E5.B0.86.E6.B6.88.E6.81.AF.E8.BD.AC.E5.8F.91.E5.88.B0.E5.A4.9A.E5.AE.A2.E6.9C.8D"><a href="../11/f0e34a15cec66fefb28cf1c0388f68ab.html">将消息转发到多客服</a></li> 
        <li id="n-.E5.AE.A2.E6.9C.8D.E7.AE.A1.E7.90.86"><a href="../18/749901f4e123170fb8a4d447ae6040ba.html">客服管理</a></li> 
        <li id="n-.E5.A4.9A.E5.AE.A2.E6.9C.8D.E4.BC.9A.E8.AF.9D.E6.8E.A7.E5.88.B6"><a href="../4/4b256cfb246b22ad020e07cf8a61a738.html">多客服会话控制</a></li> 
        <li id="n-.E8.8E.B7.E5.8F.96.E5.AE.A2.E6.9C.8D.E8.81.8A.E5.A4.A9.E8.AE.B0.E5.BD.95"><a href="../3/178d2982bd590adf33fc03cf6cf45b33.html">获取客服聊天记录</a></li> 
        <li id="n-PC.E5.AE.A2.E6.88.B7.E7.AB.AF.E8.87.AA.E5.AE.9A.E4.B9.89.E6.8F.92.E4.BB.B6.E6.8E.A5.E5.8F.A3"><a href="../8/3634566e351f497f508c7b9d04636724.html">PC客户端自定义插件接口</a></li> 
       </ul> 
      </div> 
     </div> 
     <!-- /微信多客服功能 --> 
     <!-- 微信摇一摇周边 --> 
     <div class="portal" id="p-.E5.BE.AE.E4.BF.A1.E6.91.87.E4.B8.80.E6.91.87.E5.91.A8.E8.BE.B9"> 
      <h5><span class="portal_arrow"></span>微信摇一摇周边</h5> 
      <div class="body"> 
       <ul> 
        <li id="n-.E7.94.B3.E8.AF.B7.E5.BC.80.E9.80.9A.E6.91.87.E4.B8.80.E6.91.87.E5.91.A8.E8.BE.B9"><a href="../19/9fe9fdbb50fee9f9660438c551142ccf.html">申请开通摇一摇周边</a></li> 
        <li id="n-.E8.AE.BE.E5.A4.87.E7.AE.A1.E7.90.86"><a href="../15/095caa2f4a829f0299db617eaf6ad1cf.html">设备管理</a></li> 
        <li id="n-.E9.A1.B5.E9.9D.A2.E7.AE.A1.E7.90.86"><a href="../15/7a21268ed234b4e648d86e3b91118907.html">页面管理</a></li> 
        <li id="n-.E7.B4.A0.E6.9D.90.E7.AE.A1.E7.90.86"><a href="../12/3b10084ee944a702fd06e54a0f10b1d8.html">素材管理</a></li> 
        <li id="n-.E7.AE.A1.E7.90.86.E8.AE.BE.E5.A4.87.E4.B8.8E.E9.A1.B5.E9.9D.A2.E7.9A.84.E5.85.B3.E8.81.94.E5.85.B3.E7.B3.BB"><a href="../6/0eb3f80f152d2edb95287141e7a6ab5e.html">管理设备与页面的关联关系</a></li> 
        <li id="n-.E8.8E.B7.E5.8F.96.E8.AE.BE.E5.A4.87.E5.8F.8A.E7.94.A8.E6.88.B7.E4.BF.A1.E6.81.AF"><a href="../12/f18e741c4cab6652afe3878774672de4.html">获取设备及用户信息</a></li> 
        <li id="n-.E6.95.B0.E6.8D.AE.E7.BB.9F.E8.AE.A1"><a href="../3/15da0147e3722fd689f363497af0c707.html">数据统计</a></li> 
        <li id="n-.E6.91.87.E4.B8.80.E6.91.87.E5.85.B3.E6.B3.A8JSAPI"><a href="../4/94e3b1dc0416633a2d7f1cfaa71240c8.html">摇一摇关注JSAPI</a></li> 
        <li id="n-.E6.91.87.E4.B8.80.E6.91.87.E4.BA.8B.E4.BB.B6.E9.80.9A.E7.9F.A5"><a href="../3/c71248e1b3efb158f258a48b72e67683.html">摇一摇事件通知</a></li> 
        <li id="n-.E6.91.87.E4.B8.80.E6.91.87.E7.BA.A2.E5.8C.85"><a href="../7/0ddd50ed2421b99fedd071281c074aab.html">摇一摇红包</a></li> 
        <li id="n-Html-5.E9.A1.B5.E9.9D.A2.E8.8E.B7.E5.8F.96.E8.AE.BE.E5.A4.87.E4.BF.A1.E6.81.AF"><a href="../11/c156a3e968b0c1e78157e15275dcc54b.html">Html 5页面获取设备信息</a></li> 
        <li id="n-.E6.91.87.E4.B8.80.E6.91.87.E5.91.A8.E8.BE.B9.E9.94.99.E8.AF.AF.E7.A0.81"><a href="../1/8299371e6e11392757b23a6d1e592331.html">摇一摇周边错误码</a></li> 
       </ul> 
      </div> 
     </div> 
     <!-- /微信摇一摇周边 --> 
     <!-- 微信连Wi-Fi --> 
     <div class="portal" id="p-.E5.BE.AE.E4.BF.A1.E8.BF.9EWi-Fi"> 
      <h5><span class="portal_arrow"></span>微信连Wi-Fi</h5> 
      <div class="body"> 
       <ul> 
        <li id="n-.E5.BE.AE.E4.BF.A1.E8.BF.9EWi-Fi.E5.BC.80.E5.8F.91.E8.80.85.E6.8C.87.E5.BC.95"><a href="../9/fd2d692e28b938a8d618f57cf9c79fb1.html">微信连Wi-Fi开发者指引</a></li> 
        <li id="n-Wi-Fi.E7.A1.AC.E4.BB.B6.E9.89.B4.E6.9D.83.E5.8D.8F.E8.AE.AE.E6.8E.A5.E5.8F.A3.E8.AF.B4.E6.98.8E"><a href="../10/0ef643c7147fdf689e0a780d8c08ab96.html">Wi-Fi硬件鉴权协议接口说明</a></li> 
        <li id="n-Wi-Fi.E8.BD.AF.E4.BB.B6.E6.9C.8D.E5.8A.A1.E7.AE.A1.E7.90.86.E6.8E.A5.E5.8F.A3.E8.AF.B4.E6.98.8E"><a href="../14/70e147b2ace3247f88f1c2aaaa57568e.html">Wi-Fi软件服务管理接口说明</a></li> 
        <li id="n-.E5.BC.80.E9.80.9A.E5.BE.AE.E4.BF.A1.E8.BF.9EWi-Fi.E6.8F.92.E4.BB.B6"><a href="../11/a6a3731b23ed4203f5d08030cd5bf4c3.html">开通微信连Wi-Fi插件</a></li> 
        <li id="n-Wi-Fi.E9.97.A8.E5.BA.97.E7.AE.A1.E7.90.86"><a href="../9/0afbb08a0f06e87dd3669a2c1e19edd5.html">Wi-Fi门店管理</a></li> 
        <li id="n-Wi-Fi.E8.AE.BE.E5.A4.87.E7.AE.A1.E7.90.86"><a href="../17/438e819a53e9426b202c3bc0afbad749.html">Wi-Fi设备管理</a></li> 
        <li id="n-.E9.85.8D.E7.BD.AE.E8.BF.9E.E7.BD.91.E6.96.B9.E5.BC.8F"><a href="../17/22648869929525f829a3de1bfc73eb4d.html">配置连网方式</a></li> 
        <li id="n-.E5.95.86.E5.AE.B6.E4.B8.BB.E9.A1.B5.E7.AE.A1.E7.90.86"><a href="../14/4e14adf8639aeb67d42df05cb792da9e.html">商家主页管理</a></li> 
        <li id="n-Wi-Fi.E6.95.B0.E6.8D.AE.E7.BB.9F.E8.AE.A1"><a href="../11/f5f481aeeb62b9b0848315f78123b4d7.html">Wi-Fi数据统计</a></li> 
        <li id="n-.E8.BF.9E.E7.BD.91.E5.90.8E.E4.B8.8B.E5.8F.91.E6.B6.88.E6.81.AF"><a href="../19/bac84e64da24f928c3e536c742d4e0b7.html">连网后下发消息</a></li> 
        <li id="n-Wi-Fi.E9.94.99.E8.AF.AF.E7.A0.81"><a href="../9/b1211ca9404ec481f94e88d0dd344e85.html">Wi-Fi错误码</a></li> 
       </ul> 
      </div> 
     </div> 
     <!-- /微信连Wi-Fi --> 
     <!-- 微信扫一扫 --> 
     <div class="portal" id="p-.E5.BE.AE.E4.BF.A1.E6.89.AB.E4.B8.80.E6.89.AB"> 
      <h5><span class="portal_arrow"></span>微信扫一扫</h5> 
      <div class="body"> 
       <ul> 
        <li id="n-.E6.89.AB.E4.B8.80.E6.89.AB.E6.8E.A5.E5.85.A5.E6.8C.87.E5.8D.97"><a href="../19/e833eb10470cc25cad4719677c46ecdb.html">扫一扫接入指南</a></li> 
        <li id="n-.E5.95.86.E5.93.81.E5.88.9B.E5.BB.BA"><a href="../6/c61604ff6890d386d6227945ad4a68d2.html">商品创建</a></li> 
        <li id="n-.E5.95.86.E5.93.81.E5.8F.91.E5.B8.83"><a href="../15/1007691d0f1c10a0588c6517f12ed70f.html">商品发布</a></li> 
        <li id="n-.E5.95.86.E5.93.81.E7.AE.A1.E7.90.86"><a href="../15/7fa787701295b884410b5163e13313af.html">商品管理</a></li> 
        <li id="n-.E6.89.AB.E4.B8.80.E6.89.AB.E4.BA.8B.E4.BB.B6.E6.8E.A8.E9.80.81"><a href="../15/f4109a5e44b4bfbc7eb1337eb739f3e3.html">扫一扫事件推送</a></li> 
        <li id="n-.E9.94.99.E8.AF.AF.E7.A0.81"><a href="../7/91dcb5ffa7d087a23299316c3c396e93.html">错误码</a></li> 
        <li id="n-.E5.9C.A8.E7.BA.BF.E5.B8.AE.E5.8A.A9.E5.B7.A5.E5.85.B7"><a href="../11/9f75990a5e9f6c09c846fd918921e0d7.html">在线帮助工具</a></li> 
        <li id="n-.E6.89.AB.E4.B8.80.E6.89.AB.E5.B8.B8.E8.A7.81.E9.97.AE.E9.A2.98"><a href="../15/b11cde45d1dcb23a94f493dd1e1320cb.html">扫一扫常见问题</a></li> 
       </ul> 
      </div> 
     </div> 
     <!-- /微信扫一扫 --> 
     <!-- SEARCH --> 
     <!-- /SEARCH --> 
     <!-- TOOLBOX --> 
     <!-- /TOOLBOX --> 
     <!-- LANGUAGES --> 
     <!-- /LANGUAGES --> 
    </div> 
    <!-- /panel --> 
    <!-- content --> 
    <div id="content"> 
     <!-- header --> 
     <div id="mw-head" class="noprint" style="visibility:hidden"> 
      <!-- 0 --> 
      <div id="p-personal" class=""> 
       <h5>个人工具</h5> 
       <ul> 
        <li id="pt-anonuserpage"><a href="../0/f33145bff5a2445cabbd49fc12e8f2e0.html" title="您编辑本站所用IP的对应用户页 [.]" accesskey="." class="new">10.9.161.40</a></li> 
        <li id="pt-anontalk"><a href="../12/4aa3e991f9670e48be3d9c6d01c4c568.html" title="对于来自此IP地址的编辑的对话 [n]" accesskey="n" class="new">该IP的讨论页</a></li> 
        <li id="pt-anonlogin"><a href="../11/977572c1f1b361c2222f4f9f9bd287e7.html" title="我们鼓励您登录，但这并不是必须的 [o]" accesskey="o">登录</a></li> 
       </ul> 
      </div> 
      <!-- /0 --> 
      <div id="left-navigation"> 
       <!-- 0 --> 
       <div id="p-namespaces" class="vectorTabs"> 
        <h5>名字空间</h5> 
        <ul> 
         <li id="ca-nstab-main" class="selected"><span><a href="../7/0ddd50ed2421b99fedd071281c074aab.html" title="查看页面内容 [c]" accesskey="c">页面</a></span></li> 
         <li id="ca-talk" class="new"><span><a href="#" title="关于页面正文的讨论 [t]" accesskey="t">讨论</a></span></li> 
        </ul> 
       </div> 
       <!-- /0 --> 
       <!-- 1 --> 
       <div id="p-variants" class="vectorMenu emptyPortlet"> 
        <h5><span>变换</span><a href="#"></a></h5> 
        <div class="menu"> 
         <ul> 
         </ul> 
        </div> 
       </div> 
       <!-- /1 --> 
      </div> 
      <div id="right-navigation"> 
       <!-- 0 --> 
       <div id="p-views" class="vectorTabs"> 
        <h5>查看</h5> 
        <ul> 
         <li id="ca-view" class="selected"><span><a href="../7/0ddd50ed2421b99fedd071281c074aab.html">阅读</a></span></li> 
         <li id="ca-viewsource"><span><a href="#" title="此页面已被保护，你可以查看其源代码。 [e]" accesskey="e">查看源代码</a></span></li> 
         <li id="ca-history" class="collapsible "><span><a href="#" title="此页面的早前修订版本 [h]" accesskey="h">查看历史</a></span></li> 
        </ul> 
       </div> 
       <!-- /0 --> 
       <!-- 1 --> 
       <div id="p-cactions" class="vectorMenu emptyPortlet"> 
        <h5><span>动作</span><a href="#"></a></h5> 
        <div class="menu"> 
         <ul> 
         </ul> 
        </div> 
       </div> 
       <!-- /1 --> 
       <!-- 2 --> 
       <div id="p-search"> 
        <h5><label for="searchInput">搜索</label></h5> 
        <form action="/wiki/index.php" id="searchform"> 
         <input type="hidden" name="title" value="特殊:搜索"> 
         <input id="searchInput" name="search" type="text" title="搜索该网站 [f]" accesskey="f" value=""> 
         <input type="submit" name="go" class="searchButton" id="searchGoButton" value="进入" title="如果相同的标题存在的话便直接前往该页面"> 
         <input type="submit" name="fulltext" class="searchButton" id="mw-searchButton" value="搜索" title="搜索该文字的页面"> 
        </form> 
       </div> 
       <!-- /2 --> 
      </div> 
     </div> 
     <!-- /header --> 
     <a id="top"></a> 
     <div id="mw-js-message" style="display:none;"></div> 
     <!-- firstHeading --> 
     <div class="content_hd"> 
      <h2 id="firstHeading" class="">摇一摇红包</h2> 
      <div class="info"> 
      </div> 
     </div> 
     <!-- /firstHeading --> 
     <!-- bodyContent --> 
     <div id="bodyContent" class="bodyContent"> 
      <!-- tagline --> 
      <div id="siteSub">
       出自微信公众平台开发者文档
      </div> 
      <!-- /tagline --> 
      <!-- subtitle --> 
      <div id="contentSub"></div> 
      <!-- /subtitle --> 
      <!-- jumpto --> 
      <div id="jump-to-nav">
        跳转到： 
       <a href="#mw-head">导航</a>, 
       <a href="#p-search">搜索</a> 
      </div> 
      <!-- /jumpto --> 
      <!-- bodytext --> 
      <table id="toc" class="toc">
       <tbody>
        <tr>
         <td>
          <div id="toctitle">
           <h2>目录</h2>
          </div> 
          <ul> 
           <li class="toclevel-1 tocsection-1"><a href="#.E6.91.87.E4.B8.80.E6.91.87.E7.BA.A2.E5.8C.85.E8.AF.B4.E6.98.8E"><span class="tocnumber">1</span> <span class="toctext">摇一摇红包说明</span></a></li> 
           <li class="toclevel-1 tocsection-2"><a href="#.E7.BA.A2.E5.8C.85.E9.A2.84.E4.B8.8B.E5.8D.95.E6.8E.A5.E5.8F.A3"><span class="tocnumber">2</span> <span class="toctext">红包预下单接口</span></a></li> 
           <li class="toclevel-1 tocsection-3"><a href="#.E5.88.9B.E5.BB.BA.E7.BA.A2.E5.8C.85.E6.B4.BB.E5.8A.A8"><span class="tocnumber">3</span> <span class="toctext">创建红包活动</span></a></li> 
           <li class="toclevel-1 tocsection-4"><a href="#.E5.BD.95.E5.85.A5.E7.BA.A2.E5.8C.85.E4.BF.A1.E6.81.AF"><span class="tocnumber">4</span> <span class="toctext">录入红包信息</span></a></li> 
           <li class="toclevel-1 tocsection-5"><a href="#.E8.AE.BE.E7.BD.AE.E7.BA.A2.E5.8C.85.E6.B4.BB.E5.8A.A8.E6.8A.BD.E5.A5.96.E5.BC.80.E5.85.B3"><span class="tocnumber">5</span> <span class="toctext">设置红包活动抽奖开关</span></a></li> 
           <li class="toclevel-1 tocsection-6"><a href="#.E7.BA.A2.E5.8C.85JSAPI"><span class="tocnumber">6</span> <span class="toctext">红包JSAPI</span></a></li> 
           <li class="toclevel-1 tocsection-7"><a href="#.E7.BA.A2.E5.8C.85.E7.BB.91.E5.AE.9A.E7.94.A8.E6.88.B7.E4.BA.8B.E4.BB.B6.E9.80.9A.E7.9F.A5"><span class="tocnumber">7</span> <span class="toctext">红包绑定用户事件通知</span></a></li> 
           <li class="toclevel-1 tocsection-8"><a href="#.E7.BA.A2.E5.8C.85.E6.9F.A5.E8.AF.A2.E6.8E.A5.E5.8F.A3"><span class="tocnumber">8</span> <span class="toctext">红包查询接口</span></a></li> 
          </ul> </td>
        </tr>
       </tbody>
      </table> 
      <h3> <span class="mw-headline" id=".E6.91.87.E4.B8.80.E6.91.87.E7.BA.A2.E5.8C.85.E8.AF.B4.E6.98.8E"><b>摇一摇红包说明</b></span></h3> 
      <p><b>功能说明</b> </p>
      <p>摇一摇周边红包接口是为线下商户提供的发红包功能。用户可以在商家门店等线下场所通过摇一摇周边领取商家发放的红包，在线上转发分享无效。 </p>
      <p>开发者可通过接口开发摇一摇红包功能，特点包括： </p> 
      <ol>
       <li> 可选择使用模板加载页或自定义Html5页面调起微信原生红包页面(详见创建红包活动中use_template字段，1为使用模板，2为使用自定义Html5页面) </li>
       <li> 原生红包页面拆红包，无需通过公众号消息下发 </li>
       <li> 提供关注公众号能力，用户可自行选择是否关注(裂变红包分享时无效) </li>
       <li> 完成页面可配置跳转链接，可跳转商户的其他自定义Html5页面 </li>
       <li> 同一个用户在单个红包活动中只能领取1次红包 </li>
      </ol> 
      <p><br> <b>用户侧交互流程</b> </p> 
      <div class="thumb tleft">
       <div class="thumbinner" style="width:602px;">
        <a href="#" class="image"><img alt="流程图1.jpg" src="../static/assets/2dd53c1e5e439bfc344eb2a5aee39f47.jpg" width="600" height="546" class="thumbimage"></a> 
        <div class="thumbcaption">
         <div class="magnify">
          <a href="#" class="internal" title="放大"><img src="../static/assets/c1025b3d1d3c4256a7ed52adf0d9212f.png" width="15" height="11" alt=""></a>
         </div>
        </div>
       </div>
      </div> 
      <div class="thumb tleft">
       <div class="thumbinner" style="width:602px;">
        <a href="#" class="image"><img alt="流程图2.jpg" src="../static/assets/f06a6a93411eb1247d9512a3acd7d065.jpg" width="600" height="292" class="thumbimage"></a> 
        <div class="thumbcaption">
         <div class="magnify">
          <a href="#" class="internal" title="放大"><img src="../static/assets/c1025b3d1d3c4256a7ed52adf0d9212f.png" width="15" height="11" alt=""></a>
         </div>
        </div>
       </div>
      </div> 
      <p><b>红包组件接口调用流程</b> </p> 
      <ol>
       <li> 申请红包接口权限：登录摇一摇周边商户后台<a href="https://zb.weixin.qq.com" class="external free" rel="nofollow">https://zb.weixin.qq.com</a> ,进入开发者支持，申请开通摇一摇红包组件接口; </li>
       <li> 红包预下单：调用微信支付的api进行红包预下单，告知需要发放的红包金额，人数，生成红包ticket； </li>
       <li> 创建活动并录入红包信息：调用摇周边平台的api录入创建红包活动并录入信息，传入预下单时生成的红包ticket； </li>
       <li> 调用jsapi抽红包：在摇出的页面中通过调用jsapi抽红包，抽中红包的用户可以拆红包； </li>
       <li> 调用以上接口时，红包提供商户和红包发放商户公众号要求一致。 </li>
      </ol> 
      <pre> 说明：
  红包提供商户：红包预下单接口传入的参数wxappid所代表的商户
  红包发放商户：调用红包接口创建红包活动、录入红包信息、发放红包的商户公众号
</pre> 
      <h3> <span class="mw-headline" id=".E7.BA.A2.E5.8C.85.E9.A2.84.E4.B8.8B.E5.8D.95.E6.8E.A5.E5.8F.A3"><b>红包预下单接口</b></span></h3> 
      <p><b>接口说明</b> </p>
      <p>设置单个红包的金额，类型等，生成红包信息。预下单完成后，需要在72小时内调用jsapi完成抽红包的操作。（红包过期失效后，资金会退回到商户财付通帐号。） </p>
      <p><b>接口调用说明</b> </p> 
      <pre>服务器端调用
http请求方式: POST
<a href="https://api.mch.weixin.qq.com/mmpaymkttransfers/hbpreorder" class="external free" rel="nofollow">https://api.mch.weixin.qq.com/mmpaymkttransfers/hbpreorder</a>
POST数据格式：XML
需要商户证书
</pre> 
      <p><b>请求参数说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="6" align="center" width="640px"> 
       <tbody>
        <tr> 
         <th style="width:80px">参数 </th> 
         <th>字段 </th> 
         <th style="width:80px">是否必须 </th> 
         <th>示例值 </th> 
         <th style="width:80px">类型 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td> 随机字符串 </td> 
         <td> nonce_str </td> 
         <td> 是 </td> 
         <td> 5K8264ILTKCH16CQ2502SI8Z <p>NMTM67VS </p> </td> 
         <td> String(32) </td> 
         <td> 随机字符串，不长于32位 </td>
        </tr> 
        <tr> 
         <td> 签名 </td> 
         <td> sign </td> 
         <td> 是 </td> 
         <td> C380BEC2BFD727A4B68451335 <p>19F3AD6 </p> </td> 
         <td> String(32) </td> 
         <td> 生成签名方式查看签名算法 </td>
        </tr> 
        <tr> 
         <td> 商户订单号 </td> 
         <td> mch_billno </td> 
         <td> 是 </td> 
         <td> 10000098201411111234567890 </td> 
         <td> String(28) </td> 
         <td> 商户订单号（每个订单号必须唯一）组成： mch_id+yyyymmdd+10位一天内不能重复的数字。接口根据商户订单号支持重入， 如出现超时可再调用。 </td>
        </tr> 
        <tr> 
         <td> 商户号 </td> 
         <td> mch_id </td> 
         <td> 是 </td> 
         <td> 10000098 </td> 
         <td> String(32) </td> 
         <td> 红包提供者的商户号（微信支付分配的商户号） </td>
        </tr> 
        <tr> 
         <td> 公众账号appid </td> 
         <td> wxappid </td> 
         <td> 是 </td> 
         <td> wx8888888888888888 </td> 
         <td> String(32) </td> 
         <td> 红包提供者公众号的appid，对应头像展示在红包页面 </td>
        </tr> 
        <tr> 
         <td> 商户名称 </td> 
         <td> send_name </td> 
         <td> 是 </td> 
         <td> 天虹百货 </td> 
         <td> String(32) </td> 
         <td> 红包提供者名称，展示在红包页面 </td>
        </tr> 
        <tr> 
         <td> 红包类型 </td> 
         <td> hb_type </td> 
         <td> 是 </td> 
         <td> NORMAL </td> 
         <td> String(16) </td> 
         <td> NORMAL-普通红包；GROUP-裂变红包(可分享红包给好友，无关注公众号能力)。 </td>
        </tr> 
        <tr> 
         <td> 总金额 </td> 
         <td> total_amount </td> 
         <td> 是 </td> 
         <td> 1000 </td> 
         <td> int </td> 
         <td> 总付款金额，单位分 </td>
        </tr> 
        <tr> 
         <td> 红包发放总人数 </td> 
         <td> total_num </td> 
         <td> 是 </td> 
         <td> 1 </td> 
         <td> int </td> 
         <td> 红包发放总人数，即总共有多少人可以领到该组红包（包括分享者）。普通红包填1，裂变红包必须大于1。 </td>
        </tr> 
        <tr> 
         <td> 红包金额设置方式 </td> 
         <td> amt_type </td> 
         <td> 是 </td> 
         <td> ALL_RAND </td> 
         <td> String(32) </td> 
         <td> 红包金额设置方式，只对裂变红包生效。ALL_RAND—全部随机 </td>
        </tr> 
        <tr> 
         <td> 红包祝福语 </td> 
         <td> wishing </td> 
         <td> 是 </td> 
         <td> 感谢您参加猜灯谜活动，祝您元宵节快乐 </td> 
         <td> String(16) </td> 
         <td> 红包祝福语，展示在红包页面 </td>
        </tr> 
        <tr> 
         <td> 活动名称 </td> 
         <td> act_name </td> 
         <td> 是 </td> 
         <td> 猜灯谜抢红包活动 </td> 
         <td> String(32) </td> 
         <td> 活动名称，在不支持原生红包的微信版本中展示在红包消息 </td>
        </tr> 
        <tr> 
         <td> 备注 </td> 
         <td> remark </td> 
         <td> 是 </td> 
         <td> 猜越多得越多，快来抢！ </td> 
         <td> String(32) </td> 
         <td> 备注信息，在不支持原生红包的微信版本中展示在红包消息 </td>
        </tr> 
        <tr> 
         <td> 授权商户号 </td> 
         <td> auth_mchid </td> 
         <td> 是 </td> 
         <td> 1000052601 </td> 
         <td> String(32) </td> 
         <td> 用于发红包时微信支付识别摇周边红包，所有开发者统一填写摇周边平台的商户号：1000052601 </td>
        </tr> 
        <tr> 
         <td> 授权商户APPID </td> 
         <td> auth_appid </td> 
         <td> 是 </td> 
         <td> wxbf42bd79c4391863 </td> 
         <td> String(32) </td> 
         <td> 用于发红包时微信支付识别摇周边红包，所有开发者统一填写摇周边平台的appid:wxbf42bd79c4391863 </td>
        </tr> 
        <tr> 
         <td> 风控设置 </td> 
         <td> risk_cntl </td> 
         <td> 是 </td> 
         <td> NORMAL </td> 
         <td> String(32) </td> 
         <td> 用于管控接口风险。具体值如下：NORMAL—正常情况；IGN_FREQ_LMT—忽略防刷限制，强制发放；IGN_DAY_LMT—忽略单用户日限额限制，强制发放；IGN_FREQ_DAY_LMT—忽略防刷和单用户日限额限制，强制发放；如无特殊要求，请设为NORMAL。若忽略某项风险控制，可能造成资金损失，请谨慎使用。 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>请求示例</b> </p> 
      <pre>&lt;xml&gt;     
&lt;sign&gt;&lt;![CDATA[E1EE61A91C8E90F299DE6AE075D60A2D]]&gt;&lt;/sign&gt;     
&lt;mch_billno&gt;&lt;![CDATA[0010010404201411170000046545]]&gt;&lt;/mch_billno&gt;     
&lt;mch_id&gt;&lt;![CDATA[10000097]]&gt;&lt;/mch_id&gt;     
&lt;wxappid&gt;&lt;![CDATA[wxcbda96de0b165486]]&gt;&lt;/wxappid&gt;     
&lt;send_name&gt;&lt;![CDATA[send_name]]&gt;&lt;/send_name&gt;     
&lt;hb_type&gt;&lt;![CDATA[NORMAL]]&gt;&lt;/hb_type&gt;     
&lt;auth_mchid&gt;&lt;![CDATA[10000098]]&gt;&lt;/auth_mchid&gt;     
&lt;auth_appid&gt;&lt;![CDATA[wx7777777]]&gt;&lt;/auth_appid&gt;     
&lt;total_amount&gt;&lt;![CDATA[200]]&gt;&lt;/total_amount&gt;     
&lt;amt_type&gt;&lt;![CDATA[ALL_RAND]]&gt;&lt;/amt_type&gt;     
&lt;total_num&gt;&lt;![CDATA[3]]&gt;&lt;/total_num&gt;     
&lt;wishing&gt;&lt;![CDATA[恭喜发财 ]]&gt;&lt;/wishing&gt;     
&lt;act_name&gt;&lt;![CDATA[ 新年红包 ]]&gt;&lt;/act_name&gt;     
&lt;remark&gt;&lt;![CDATA[新年红包 ]]&gt;&lt;/remark&gt;     
&lt;risk_cntl&gt;&lt;![CDATA[NORMAL]]&gt;&lt;/risk_cntl&gt;     
&lt;nonce_str&gt;&lt;![CDATA[50780e0cca98c8c8e814883e5caa672e]]&gt;&lt;/nonce_str&gt;
&lt;/xml&gt;
 
</pre> 
      <p><b>返回数据说明</b> </p>
      <p>返回格式为xml </p> 
      <table border="1" cellspacing="0" cellpadding="6" align="center" width="640px"> 
       <tbody>
        <tr> 
         <th style="width:80px">参数 </th> 
         <th>字段 </th> 
         <th style="width:80px">是否必须 </th> 
         <th>示例值 </th> 
         <th style="width:80px">类型 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td> 返回状态码 </td> 
         <td> return_code </td> 
         <td> 是 </td> 
         <td> SUCCESS </td> 
         <td> String(16) </td> 
         <td> SUCCESS/FAIL；此字段是通信标识，非交易标识，交易是否成功需要查看result_code来判断 </td>
        </tr> 
        <tr> 
         <td> 返回信息 </td> 
         <td> return_msg </td> 
         <td> 否 </td> 
         <td> 签名失败 </td> 
         <td> String(128) </td> 
         <td> 返回信息，如非空，为错误原因 签名失败 参数格式校验错误 </td>
        </tr> 
       </tbody>
      </table> 
      <p>以下字段在return_code为SUCCESS的时候有返回 </p> 
      <table border="1" cellspacing="0" cellpadding="6" align="center" width="640px"> 
       <tbody>
        <tr> 
         <th style="width:80px">参数 </th> 
         <th>字段 </th> 
         <th style="width:80px">是否必须 </th> 
         <th>示例值 </th> 
         <th style="width:80px">类型 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td> 签名 </td> 
         <td> sign </td> 
         <td> 是 </td> 
         <td> C380BEC2BFD727A4B6845133519F3AD6 </td> 
         <td> String(32) </td> 
         <td> 生成签名方式查看 签名算法 </td>
        </tr> 
        <tr> 
         <td> 业务结果 </td> 
         <td> result_code </td> 
         <td> 是 </td> 
         <td> SUCCESS </td> 
         <td> String(16) </td> 
         <td> SUCCESS/FAIL </td>
        </tr> 
        <tr> 
         <td> 错误代码 </td> 
         <td> err_code </td> 
         <td> 否 </td> 
         <td> SUCCESS </td> 
         <td> String(32) </td> 
         <td> 错误码信息 </td>
        </tr> 
        <tr> 
         <td> 错误代码描述 </td> 
         <td> err_code_des </td> 
         <td> 否 </td> 
         <td> 系统错误 </td> 
         <td> String(128) </td> 
         <td> 结果信息描述 </td>
        </tr> 
       </tbody>
      </table> 
      <p>以下字段在return_code 和result_code都为SUCCESS的时候有返回 </p> 
      <table border="1" cellspacing="0" cellpadding="6" align="center" width="640px"> 
       <tbody>
        <tr> 
         <th style="width:80px">参数 </th> 
         <th>字段 </th> 
         <th style="width:80px">是否必须 </th> 
         <th>示例值 </th> 
         <th style="width:80px">类型 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td> 商户订单号 </td> 
         <td> mch_billno </td> 
         <td> 是 </td> 
         <td> 10000098201411111234567890 </td> 
         <td> String(28) </td> 
         <td> 商户订单号（每个订单号必须唯一）组成： mch_id+yyyymmdd+10位一天内不能重复的数字。 </td>
        </tr> 
        <tr> 
         <td> 商户号 </td> 
         <td> mch_id </td> 
         <td> 是 </td> 
         <td> 10000098 </td> 
         <td> String(32) </td> 
         <td> 微信支付分配的商户号 </td>
        </tr> 
        <tr> 
         <td> 公众账号appid </td> 
         <td> wxappid </td> 
         <td> 是 </td> 
         <td> wx8888888888888888 </td> 
         <td> String(32) </td> 
         <td> 商户appid </td>
        </tr> 
        <tr> 
         <td> 总金额 </td> 
         <td> total_amount </td> 
         <td> 是 </td> 
         <td> 1000 </td> 
         <td> int </td> 
         <td> 总付款金额，单位分 </td>
        </tr> 
        <tr> 
         <td> ticket </td> 
         <td> sp_ticket </td> 
         <td> 是 </td> 
         <td>2J6MtR+SlbZ8Ga4EDi64X5 <p>vC4Xv01ofX4uWOqqTc9kGJYhkq5 st5ucrXKxkjnC/UuvLeuhdIfiYg i4hJuJ95qjt9mwxqSBEmjGbZlL+ sqM9upoWsEjup28KPvaVrdao/Hg 6WqyqUL5E2zPHfM1sb1w== </p> </td> 
         <td> String </td> 
         <td> sp_ticket，一个普通红包对应一个ticket </td>
        </tr> 
        <tr> 
         <td> 红包订单号 </td> 
         <td> detail_id </td> 
         <td> 是 </td> 
         <td> 0000000666201504290000042120 </td> 
         <td> </td> 
         <td> 红包内部订单号 </td>
        </tr> 
        <tr> 
         <td> 发送时间 </td> 
         <td> </td> 
         <td> 是 </td> 
         <td> 20150429203444 </td> 
         <td> </td> 
         <td> 红包发放时间 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>成功示例</b> </p> 
      <pre>&lt;xml&gt; 	
&lt;return_code&gt;&lt;![CDATA[SUCCESS]]&gt;&lt;/return_code&gt; 	
&lt;return_msg&gt;&lt;![CDATA[发放成功.]]&gt;&lt;/return_msg&gt; 
&lt;result_code&gt;&lt;![CDATA[SUCCESS]]&gt;&lt;/result_code&gt; 
&lt;err_code&gt;&lt;![CDATA[0]]&gt;&lt;/err_code&gt; 	
&lt;err_code_des&gt;&lt;![CDATA[发放成功.]]&gt;&lt;/err_code_des&gt; 	
&lt;mch_billno&gt;&lt;![CDATA[0010010404201411170000046545]]&gt;&lt;/mch_billno&gt; 
&lt;mch_id&gt;10010404&lt;/mch_id&gt; 	
&lt;wxappid&gt;&lt;![CDATA[wx6fa7e3bab7e15415]]&gt;&lt;/wxappid&gt; 	
&lt;sp_ticket&gt;&lt;![CDATA[0cca98c8c8e814883]]&gt;&lt;/sp_ticket&gt; 
&lt;total_amount&gt;3&lt;/total_amount&gt; 	
&lt;detail_id&gt;&lt;![CDATA[001001040420141117000004888]]&gt;&lt;/detail_id&gt; 
&lt;send_time&gt;&lt;![CDATA[20150101080000]]&gt;&lt;/send_time&gt; 
&lt;/xml&gt;  
</pre> 
      <p><b>失败示例</b> </p> 
      <pre>&lt;xml&gt;     
&lt;return_code&gt;&lt;![CDATA[FAIL]]&gt;&lt;/return_code&gt; 	
&lt;return_msg&gt;&lt;![CDATA[系统繁忙,请稍后再试.]]&gt;&lt;/return_msg&gt; 	
&lt;result_code&gt;&lt;![CDATA[FAIL]]&gt;&lt;/result_code&gt; 	
&lt;err_code&gt;&lt;![CDATA[268458547]]&gt;&lt;/err_code&gt; 	
&lt;err_code_des&gt;&lt;![CDATA[系统繁忙,请稍后再试.]]&gt;&lt;/err_code_des&gt; 	
&lt;mch_billno&gt;&lt;![CDATA[0010010404201411170000046542]]&gt;&lt;/mch_billno&gt; 	        
&lt;mch_id&gt;10010404&lt;/mch_id&gt; 	
&lt;wxappid&gt;&lt;![CDATA[wx6fa7e3bab7e15415]]&gt;&lt;/wxappid&gt; 	 
&lt;total_amount&gt;3&lt;/total_amount&gt; 
&lt;/xml&gt;
</pre> 
      <p><b>错误码</b> </p> 
      <table border="1" cellspacing="0" cellpadding="3" align="center" width="640px"> 
       <tbody>
        <tr> 
         <th style="width:200px">错误代码 </th> 
         <th>描述 </th> 
         <th>解决方案 </th>
        </tr> 
        <tr> 
         <td> CA_ERROR </td> 
         <td> 请求未携带证书，或请求携带的证书出错 </td> 
         <td> 到商户平台下载证书，请求带上证书后重试。 </td>
        </tr> 
        <tr> 
         <td> SIGN_ERROR </td> 
         <td> 商户签名错误 </td> 
         <td> 按文档要求重新生成签名后再重试。 </td>
        </tr> 
        <tr> 
         <td> NO_AUTH </td> 
         <td> 没有权限 </td> 
         <td> 请联系微信支付开通api权限。 </td>
        </tr> 
        <tr> 
         <td> FREQ_LIMIT </td> 
         <td> 受频率限制 </td> 
         <td> 请对请求做频率控制 </td>
        </tr> 
        <tr> 
         <td> XML_ERROR </td> 
         <td> 请求的xml格式错误，或者post的数据为空 </td> 
         <td> 检查请求串，确认无误后重试 </td>
        </tr> 
        <tr> 
         <td> PARAM_ERROR </td> 
         <td> 参数错误 </td> 
         <td> 请查看err_code_des，修改设置错误的参数 </td>
        </tr> 
        <tr> 
         <td> OPENID_ERROR </td> 
         <td> Openid错误 </td> 
         <td> 根据用户在商家公众账号上的openid，获取用户在红包公众账号上的openid 错误。请核对商户自身公众号appid和用户在此公众号下的openid。 </td>
        </tr> 
        <tr> 
         <td> NOTENOUGH </td> 
         <td> 余额不足 </td> 
         <td> 商户账号余额不足，请登录微信支付商户平台充值 </td>
        </tr> 
        <tr> 
         <td> FATAL_ERROR </td> 
         <td> 重复请求时，参数与原单不一致 </td> 
         <td> 使用相同商户单号进行重复请求时，参数与第一次请求时不一致，请检查并修改参数后再重试。 </td>
        </tr> 
        <tr> 
         <td> TIME _LIMITED </td> 
         <td> 企业红包的发送时间受限 </td> 
         <td> 请北京时间0：00-8：00时间之外触发红包赠送 </td>
        </tr> 
        <tr> 
         <td> SECOND_OVER_LIMITED </td> 
         <td> 企业红包的按分钟发放受限 </td> 
         <td> 每分钟发送红包数量不得超过1800个；（可联系微信支付wxhongbao@tencent.com调高额度） </td>
        </tr> 
        <tr> 
         <td> DAY_ OVER_LIMITED </td> 
         <td> 企业红包的按天日发放受限 </td> 
         <td> 单个商户日发送红包数量不大于10000个；（可联系微信支付wxhongbao@tencent.com调高额度） </td>
        </tr> 
        <tr> 
         <td> MONEY_LIMIT </td> 
         <td> 红包金额发放限制 </td> 
         <td> 每个红包金额必须大于1元，小于1000元（可联系微信支付wxhongbao@tencent.com调高额度至4999元） </td>
        </tr> 
        <tr> 
         <td> SEND_FAILED </td> 
         <td> 红包发放失败，请更换单号再重试。 </td> 
         <td> 原商户单号已经失败，如果还要对同一个用户发放红包， 需要更换新的商户单号再试。 </td>
        </tr> 
        <tr> 
         <td> SYSTEMERROR </td> 
         <td> 系统繁忙，请再试。 </td> 
         <td> 可用同一商户单号再次调用，只会发放一个红包。 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>签名算法</b> </p>
      <p>第一步，设所有发送或者接收到的数据为集合M，将集合M内非空参数值的参数按照参数名ASCII码从小到大排序（字典序），使用URL键值对的格式（即key1=value1&amp;key2=value2…）拼接成字符串stringA。 </p> 
      <pre> 特别注意以下重要规则：
 参数名ASCII码从小到大排序（字典序）；
 如果参数的值为空不参与签名；
 参数名区分大小写；
 验证调用返回或微信主动通知签名时，传送的sign参数不参与签名，将生成的签名与该sign值作校验。
</pre> 
      <p>第二步，在stringA最后拼接上key=商户支付密钥得到stringSignTemp字符串，并对stringSignTemp进行MD5运算，再将得到的字符串所有字符转换为大写，得到sign值signValue。 </p> 
      <pre> 举例：
 假设传送的参数如下：
 appid： wxd930ea5d5a258f4f
 mch_id： 10000100
 device_info： 1000
 Body： test
 nonce_str： ibuaiVcKdpRxkhJA
 第一步：对参数按照key=value的格式，并按照参数名ASCII字典序排序如下：stringA="appid=wxd930ea5d5a258f4f&amp;body=test&amp;device_info=1000&amp;mch_id=10000100&amp;nonce_str=ibuaiVcKdpRxkhJA";
 第二步：拼接支付密钥：
 stringSignTemp="stringA&amp;key=192006250b4c09247ec02edce69f6a2d"
 sign=MD5(stringSignTemp).toUpperCase()="9A0A8659F005D6984697E2CA0A9CF3B7"
 最终得到最终发送的数据：
&lt;xml&gt; 	
&lt;appid&gt;wxd930ea5d5a258f4f&lt;/appid&gt; 	
&lt;mch_id&gt;10000100&lt;/mch_id&gt; 	
&lt;device_info&gt;1000&lt;/device_info&gt; 	
&lt;body&gt;test&lt;/body&gt; 	
&lt;nonce_str&gt;ibuaiVcKdpRxkhJA&lt;/nonce_str&gt; 	
&lt;sign&gt;9A0A8659F005D6984697E2CA0A9CF3B7&lt;/sign&gt; 	
&lt;/xml&gt;
</pre> 
      <p><b>生成随机数算法</b> </p>
      <p>微信支付API接口协议中包含固定nonce_str，主要保证签名不可预测。我们推荐生成随机数算法如下： </p> 
      <pre> 调用随机数生成函数，将得到的值转换为字符串。	
</pre> 
      <p><b>商户证书</b> </p>
      <p>1. 获取商户证书 </p>
      <p>微信支付接口中，涉及资金回滚的接口会使用到商户证书，包括退款、撤销接口。商家在申请微信支付成功后，收到的相应邮件通知中，附件会包含接口需要用到的证书文件，有四个证书文件，分别说明如下。 </p>
      <p>证书文件说明： </p> 
      <table border="1" cellspacing="0" cellpadding="4" align="center" width="640px"> 
       <tbody>
        <tr> 
         <th style="width:160px">证书附件 </th> 
         <th>描述 </th> 
         <th>使用场景 </th> 
         <th>备注 </th>
        </tr> 
        <tr> 
         <td> pkcs12格式(apiclient_cert.p12) </td> 
         <td> 包含了私钥信息的证书文件，为p12(pfx)格式，由微信支付签发给您用来标识和界定您的身份 </td> 
         <td> 撤销、退款申请API中调用 </td> 
         <td> windows上可以直接双击导入系统，导入过程中会提示输入证书密码，证书密码默认为您的商户ID（如：10010000） </td>
        </tr> 
        <tr> 
         <td> 证书pem格式（apiclient_cert.pem） </td> 
         <td> 从apiclient_cert.p12中导出证书部分的文件，为pem格式，请妥善保管不要泄漏和被他人复制 </td> 
         <td> PHP等不能直接使用p12文件，而需要使用pem，为了方便您使用，已为您直接提供 </td> 
         <td> 您也可以使用openssl命令来自己导出：openssl pkcs12 -clcerts -nokeys -in apiclient_cert.p12 -out apiclient_cert.pem </td>
        </tr> 
        <tr> 
         <td> 证书密钥pem格式（apiclient_key.pem） </td> 
         <td> 从apiclient_cert.p12中导出密钥部分的文件，为pem格式 </td> 
         <td> PHP等不能直接使用p12文件，而需要使用pem，为了方便您使用，已为您直接提供 </td> 
         <td> 您也可以使用openssl命令来自己导出：openssl pkcs12 -nocerts -in apiclient_cert.p12 -out apiclient_key.pem </td>
        </tr> 
        <tr> 
         <td> CA证书（rootca.pem） </td> 
         <td> 微信支付api服务器上也部署了证明微信支付身份的服务器证书，您在使用api进行调用时也需要验证所调用服务器及域名的真实性 </td> 
         <td> 该文件为签署微信支付证书的权威机构的根证书，可以用来验证微信支付服务器证书的真实性 </td> 
         <td> 部分工具已经内置了若干权威机构的根证书，无需引用该证书也可以正常进行验证，这里提供给您在未内置所必须根证书的环境中载入使用 </td>
        </tr> 
       </tbody>
      </table> 
      <p>2. 使用商户证书 </p> 
      <pre>apiclient_cert.p12是商户证书文件，除PHP外的开发均使用此证书文件。
商户如果使用.NET环境开发，请确认Framework版本大于2.0，必须在操作系统上双击安装证书apiclient_cert.p12后才能被正常调用。
商户证书调用或安装都需要使用到密码，该密码的值为微信商户号（mchid）
PHP开发环境请使用商户证书文件apiclient_cert.pem和apiclient_key.pem ，rootca.pem是CA证书。
</pre> 
      <p>3. 商户证书安全 </p> 
      <pre>证书文件放在非web服务器虚拟目录的文件夹下，防止被他人下载。商户服务器要做好病毒和木马防护工作，不被非法侵入者窃取证书文件。
</pre> 
      <h3> <span class="mw-headline" id=".E5.88.9B.E5.BB.BA.E7.BA.A2.E5.8C.85.E6.B4.BB.E5.8A.A8"><b>创建红包活动</b></span></h3> 
      <p><b>接口说明</b> </p>
      <p>创建红包活动，设置红包活动有效期，红包活动开关等基本信息，返回活动id </p>
      <p><b>接口调用说明</b> </p> 
      <pre>服务器端调用
http请求方式: POST
URL: <a href="https://api.weixin.qq.com/shakearound/lottery/addlotteryinfo?access_token=ACCESSTOKEN&amp;use_template=1&amp;logo_url=LOGO_URL" class="external free" rel="nofollow">https://api.weixin.qq.com/shakearound/lottery/addlotteryinfo?access_token=ACCESSTOKEN&amp;use_template=1&amp;logo_url=LOGO_URL</a>
</pre> 
      <p><b>请求参数说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="3" align="center" width="640px"> 
       <tbody>
        <tr> 
         <th style="width:200px">参数 </th> 
         <th>类型 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td> access_token </td> 
         <td> string </td> 
         <td> accesstoken,以参数的形式拼装在url后 </td>
        </tr> 
        <tr> 
         <td> use_template </td> 
         <td> int </td> 
         <td> 是否使用模板，1：使用，2：不使用,以参数的形式拼装在url后。（模版即交互流程图中的红包加载页，使用模板用户不需要点击可自动打开红包；不使用模版需自行开发HTML5页面，并在页面调用红包jsapi） </td>
        </tr> 
        <tr> 
         <td> logo_url </td> 
         <td> string </td> 
         <td> 使用模板页面的logo_url，不使用模板时可不加。展示在摇一摇界面的消息图标。图片尺寸为120x120。 </td>
        </tr> 
       </tbody>
      </table> 
      <p>POST BODY：JSON格式的结构体 </p> 
      <table border="1" cellspacing="0" cellpadding="3" align="center" width="640px"> 
       <tbody>
        <tr> 
         <th style="width:200px">参数 </th> 
         <th>类型 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td> title </td> 
         <td> string </td> 
         <td> 抽奖活动名称（选择使用模板时，也作为摇一摇消息主标题），最长6个汉字，12个英文字母。 </td>
        </tr> 
        <tr> 
         <td> desc </td> 
         <td> string </td> 
         <td> 抽奖活动描述（选择使用模板时，也作为摇一摇消息副标题），最长7个汉字，14个英文字母。 </td>
        </tr> 
        <tr> 
         <td> onoff </td> 
         <td> int </td> 
         <td> 抽奖开关。0关闭，1开启，默认为1 </td>
        </tr> 
        <tr> 
         <td> begin_time </td> 
         <td> long </td> 
         <td> 抽奖活动开始时间，unix时间戳，单位秒 </td>
        </tr> 
        <tr> 
         <td> expire_time </td> 
         <td> long </td> 
         <td> 抽奖活动结束时间，unix时间戳，单位秒,红包活动有效期最长为91天 </td>
        </tr> 
        <tr> 
         <td> sponsor_appid </td> 
         <td> string </td> 
         <td> 红包提供商户公众号的appid，需与预下单中的公众账号appid（wxappid）一致 </td>
        </tr> 
        <tr> 
         <td> total </td> 
         <td> long </td> 
         <td> 红包总数，红包总数是录入红包ticket总数的上限，因此红包总数应该大于等于预下单时红包ticket总数。 </td>
        </tr> 
        <tr> 
         <td> jump_url </td> 
         <td> string </td> 
         <td> 红包关注界面后可以跳转到第三方自定义的页面 </td>
        </tr> 
        <tr> 
         <td> key </td> 
         <td> string </td> 
         <td> 开发者自定义的key，用来生成活动抽奖接口的签名参数，长度32位。使用方式见sign生成规则 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>请求示例</b> </p> 
      <pre>Content-Type: application/json Post Body:
{                                                            
 "title": "title",                           
 "desc": "desc",                             
 "onoff": 1,                                 
 "begin_time": 1428854400,                            
 "expire_time": 1428940800,                           
 "sponsor_appid": "wxxxxxxxxxxxxxx",
 "total": 10,
 "jump_url": JUMP_URL,     
 "key": "keyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy"                            
}
 
</pre> 
      <p><b>返回数据说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="3" align="center" width="640px"> 
       <tbody>
        <tr> 
         <th style="width:200px">参数 </th> 
         <th>类型 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td> errcode </td> 
         <td> int </td> 
         <td> 错误码。0为成功，其他为失败。详细请参考错误码表 </td>
        </tr> 
        <tr> 
         <td> errmsg </td> 
         <td> string </td> 
         <td> 错误信息 </td>
        </tr> 
        <tr> 
         <td> lottery_id </td> 
         <td> string </td> 
         <td> 生成的红包活动id </td>
        </tr> 
        <tr> 
         <td> page_id </td> 
         <td> int </td> 
         <td> 生成的模板页面ID </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>示例</b> </p> 
      <pre>{     
 "errcode":0,     
 "errmsg":"",     
 "lottery_id":"xxxxxxllllll", 
 "page_id":1, 
}
</pre> 
      <h3> <span class="mw-headline" id=".E5.BD.95.E5.85.A5.E7.BA.A2.E5.8C.85.E4.BF.A1.E6.81.AF"><b>录入红包信息</b></span></h3> 
      <p><b>接口说明</b> </p>
      <p>在调用"创建红包活动"接口之后，调用此接口录入红包信息。注意，此接口每次调用，都会向某个活动新增一批红包信息，如果红包数少于100个，请通过一次调用添加所有红包信息。如果红包数大于100，可以多次调用接口添加。请注意确保多次录入的红包ticket总的数目不大于创建该红包活动时设置的total值。 </p>
      <p><b>接口调用说明</b> </p> 
      <pre>服务器端调用
http请求方式: POST
URL:<a href="https://api.weixin.qq.com/shakearound/lottery/setprizebucket?access_token=ACCESSTOKEN" class="external free" rel="nofollow">https://api.weixin.qq.com/shakearound/lottery/setprizebucket?access_token=ACCESSTOKEN</a>
</pre> 
      <p><b>请求参数说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="3" align="center" width="640px"> 
       <tbody>
        <tr> 
         <th style="width:200px">参数 </th> 
         <th>类型 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td> access_token </td> 
         <td> string </td> 
         <td> accesstoken,以参数的形式拼装在url后 </td>
        </tr> 
       </tbody>
      </table> 
      <p>POST BODY：JSON格式的结构体 </p> 
      <table border="1" cellspacing="0" cellpadding="3" align="center" width="640px"> 
       <tbody>
        <tr> 
         <th style="width:200px">参数 </th> 
         <th>类型 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td> lottery_id </td> 
         <td> string </td> 
         <td> 红包抽奖id，来自addlotteryinfo返回的lottery_id </td>
        </tr> 
        <tr> 
         <td> mchid </td> 
         <td> string </td> 
         <td> 红包提供者的商户号，，需与预下单中的商户号mch_id一致 </td>
        </tr> 
        <tr> 
         <td> sponsor_appid </td> 
         <td> string </td> 
         <td> 红包提供商户公众号的appid，需与预下单中的公众账号appid（wxappid）一致 </td>
        </tr> 
        <tr> 
         <td> prize_info_list </td> 
         <td> json数组 </td> 
         <td> 红包ticket列表，如果红包数较多，可以一次传入多个红包，批量调用该接口设置红包信息。每次请求传入的红包个数上限为100 </td>
        </tr> 
        <tr> 
         <td> ticket </td> 
         <td> string </td> 
         <td> 预下单时返回的红包ticket，单个活动红包ticket数量上限为100000个，可添加多次。 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>请求示例</b> </p> 
      <pre>Content-Type: application/json Post Body:
{     
"lottery_id": "xxxxxxllllll",     
"mchid": "10000098",     
"sponsor_appid": "wx8888888888888888",   
"prize_info_list": [         
     {            
   "ticket": "v1|ZiPs2l0hpMBp3uwGI1rwp45vOdz/V/zQ/00jP9MeWT+e47/q1FJjwCIP34frSjzOxAEzJ7k2CtAg1pmcShvkChBWqbThxPm6MBuzceoHtj79iHuHaEn0WAO+j4sXnXnbGswFOlDYWg1ngvrRYnCY3g=="
     },
     {
   "ticket": "v1|fOhNUTap1oepSm5ap0hx1gmATM\/QX\/xn3sZWL7K+5Z10sbV5\/mZ4SwxwxbK2SPV32eLRvjd4ww1G3H5a+ypqRrySi+4oo97y63KoEQbRCPjbkyQBY8AYVyvD40V2b9slTQCm2igGY98mPe+VxZiayQ=="
     }
   ]
}
</pre> 
      <p><b>返回数据说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="3" align="center" width="640px"> 
       <tbody>
        <tr> 
         <th style="width:200px">参数 </th> 
         <th>类型 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td> errcode </td> 
         <td> int </td> 
         <td> 错误码。0为成功，其他为失败。详细请参考错误码表 </td>
        </tr> 
        <tr> 
         <td> errmsg </td> 
         <td> string </td> 
         <td> 错误信息 </td>
        </tr> 
        <tr> 
         <td> repeat_ticket_list </td> 
         <td> array </td> 
         <td> 重复使用的ticket列表，如为空，将不返回 </td>
        </tr> 
        <tr> 
         <td> expire_ticket_list </td> 
         <td> array </td> 
         <td> 过期的ticket列表，如为空，将不返回 </td>
        </tr> 
        <tr> 
         <td> invalid_amount_ticket_list </td> 
         <td> array </td> 
         <td> 金额不在大于1元，小于1000元的ticket列表，如为空，将不返回 </td>
        </tr> 
        <tr> 
         <td> success_num </td> 
         <td> int </td> 
         <td> 成功录入的红包数量 </td>
        </tr> 
        <tr> 
         <td> wrong_authmchid_ticket_list </td> 
         <td> array </td> 
         <td> 原因：生成红包的时候，授权商户号auth_mchid和auth_appid没有写摇周边的商户号 </td>
        </tr> 
        <tr> 
         <td> invalid_ticket_list </td> 
         <td> array </td> 
         <td> ticket解析失败，可能有错别字符或不完整 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>示例</b> </p> 
      <pre>{	     
"errcode":0,     
"errmsg":"",     
"repeat_ticket_list":[         
     {            
"ticket": "v1|ZiPs2l0hpMBp3uwGI1rwp45vOdz/V/zQ/00jP9MeWT+e47/q1FJjwCIP34frSjzOxAEzJ7k2CtAg1pmcShvkChBWqbThxPm6MBuzceoHtj79iHuHaEn0WAO+j4sXnXnbGswFOlDYWg1ngvrRYnCY3g=="                       
     },
     {
"ticket":"v1|ZiPs2l0zzXCsdfwe45dxCdHiukOdz/V/zQ/89xcnC5XnT+e47/q1FJjwCO4frSjzOxAEzJ7k2CtAg1pmcShvkChBWzc45dDGC32Dcxx4DGxczjDCGsdjowe9iHuaEn0WAO+GswFOlDYWg1ngvrRYnCY3g=="         	}    		
     } 
  ], 	
"success_num":100 
}
</pre> 
      <h3> <span class="mw-headline" id=".E8.AE.BE.E7.BD.AE.E7.BA.A2.E5.8C.85.E6.B4.BB.E5.8A.A8.E6.8A.BD.E5.A5.96.E5.BC.80.E5.85.B3"><b>设置红包活动抽奖开关</b></span></h3> 
      <p><b>接口说明</b> </p>
      <p>开发者实时控制红包活动抽奖的开启和关闭。注意活动抽奖开关只在红包活动有效期之内才能生效，如果不能确定红包活动有效期，请尽量将红包活动有效期的范围设置大。 </p>
      <p><b>接口调用说明</b> </p> 
      <pre>服务器端调用
http请求方式: Get
URL:<a href="https://api.weixin.qq.com/shakearound/lottery/setlotteryswitch?access_token=ACCESSTOKEN&amp;lottery_id=LOTTERYID&amp;onoff=1" class="external free" rel="nofollow">https://api.weixin.qq.com/shakearound/lottery/setlotteryswitch?access_token=ACCESSTOKEN&amp;lottery_id=LOTTERYID&amp;onoff=1</a>
</pre> 
      <p><b>请求参数说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="3" align="center" width="640px"> 
       <tbody>
        <tr> 
         <th style="width:200px">参数 </th> 
         <th>类型 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td> access_token </td> 
         <td> string </td> 
         <td> accesstoken,以参数的形式拼装在url后 </td>
        </tr> 
        <tr> 
         <td> lottery_id </td> 
         <td> string </td> 
         <td> 红包抽奖id，来自addlotteryinfo返回的lottery_id </td>
        </tr> 
        <tr> 
         <td> onoff </td> 
         <td> int </td> 
         <td> 活动抽奖开关，0：关闭，1：开启 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>返回数据说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="3" align="center" width="640px"> 
       <tbody>
        <tr> 
         <th style="width:200px">参数 </th> 
         <th>类型 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td> errcode </td> 
         <td> int </td> 
         <td> 错误码。0为成功，其他为失败。详细请参考错误码表 </td>
        </tr> 
        <tr> 
         <td> errmsg </td> 
         <td> string </td> 
         <td> 错误信息 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>示例</b> </p> 
      <pre>{     	
"errcode":0,    		
"errmsg":"" 	
}
</pre> 
      <h3> <span class="mw-headline" id=".E7.BA.A2.E5.8C.85JSAPI"><b>红包JSAPI</b></span></h3> 
      <p><b>接口说明</b> </p>
      <p>在第三方页面中，通过调用JSAPI来触发用户抽红包的操作，如果抽到红包，会呼出微信的原生红包页面。用户只有通过摇周边的入口才能抽中红包。每个用户在一个活动抽奖id下最多只能中一个红包。创建红包活动时，选择使用模板页面的开发者不需要调用该接口 </p>
      <p><i>引入BeaconShakehbJsBridge'</i> </p> 
      <pre>&lt;scripttype="text/javascript"src="<a href="http://zb.weixin.qq.com/app/shakehb/BeaconShakehbJsBridge.js" class="external free" rel="nofollow">http://zb.weixin.qq.com/app/shakehb/BeaconShakehbJsBridge.js</a>"&gt;
&lt;/script&gt;
</pre> 
      <p><b>API详细说明</b> </p>
      <p>抽红包JS API调用与微信的JS API调用格式一致，如下： </p> 
      <pre>函数：invoke
用途：主动调用指定API
通用形式：BeaconShakehbJsBridge.invoke("API名称", {调用参数});
API 名称：jumpHongbao
参数：openid、lottery_id、noncestr、sign
回调函数：无
</pre> 
      <p><b>调用参数说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="640px"> 
       <tbody>
        <tr> 
         <th style="width:320px">参数 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td> openid </td> 
         <td> 用户openid。必填 </td>
        </tr> 
        <tr> 
         <td> lottery_id </td> 
         <td> 红包抽奖id，必填，来自addlotteryinfo返回的lottery_id </td>
        </tr> 
        <tr> 
         <td> noncestr </td> 
         <td> 随机字符串，不长于32位。必填 </td>
        </tr> 
        <tr> 
         <td> sign </td> 
         <td> 签名，详见下面的签名生成规则 </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>Sign生成规则</b> </p> 
      <pre>1.除sign字段外，所有参数按照字段名的ASCII码从小到大排序后（字典序），使用URL键值对的格式（即Param1=value1&amp;Param2=value2…）拼接而成签名原始串，空值不参与签名组串。
2.签名原始串中，字段名和字段值都采用原始值，不进行URL转义。 
3.签名原始串末尾补上key参数(通过“创建红包活动”接口设置的key)，如 Param1=value1&amp;Param2=value2…&amp;key=keyvalue 
4.得到的字符串进行MD5，并转换为大写。即                  sign=ToUpperCase(MD5(Param1=value1&amp;Param2=value2…&amp;key=keyvalue))
5.出于安全考虑，开发者必须在服务器端实现生成签名的逻辑。
</pre> 
      <p><b>请求示例</b> </p> 
      <pre>BeaconShakehbJsBridge.ready(function(){
//跳转到抽红包页面
     BeaconShakehbJsBridge.invoke('jumpHongbao',{
     lottery_id:'LOTTERY_ID ',
     noncestr:'378507853820041854759013507217',
     openid:'OPENID',
     sign:'SIGN'
});
});
</pre> 
      <p><b>用户侧错误码说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="4" align="center" width="640px"> 
       <tbody>
        <tr> 
         <th style="width:160px">提示文案 </th> 
         <th>错误码 </th> 
         <th>错误信息 </th> 
         <th>解决方案 </th>
        </tr> 
        <tr> 
         <td> 出错了 </td> 
         <td> 5 </td> 
         <td> 摇周边ticket过期 </td> 
         <td> 检查是不是从微信摇一摇进入 </td>
        </tr> 
        <tr> 
         <td> 出错了 </td> 
         <td> 11002 </td> 
         <td> 摇一摇ticket不存在 </td> 
         <td> 检查是不是从微信摇一摇进入 </td>
        </tr> 
        <tr> 
         <td> 出错了 </td> 
         <td> 11003 </td> 
         <td> 无效的摇一摇ticket </td> 
         <td> 检查是不是从微信摇一摇进入 </td>
        </tr> 
        <tr> 
         <td> 出错了 </td> 
         <td> 11004 </td> 
         <td> 获取商户appid失败 </td> 
         <td> 检查是不是从微信摇一摇进入 </td>
        </tr> 
        <tr> 
         <td> 出错了 </td> 
         <td> 11005 </td> 
         <td> 摇周边频率检查失败 </td> 
         <td> 检查是不是从微信摇一摇进入 </td>
        </tr> 
        <tr> 
         <td> 出错了 </td> 
         <td> 11009 </td> 
         <td> 系统异常 </td> 
         <td> 请重试 </td>
        </tr> 
        <tr> 
         <td> 出错了 </td> 
         <td> 11010 </td> 
         <td> 随机字符串长度过长 </td> 
         <td> 对自定义页面时调jsapi参数校验出错，请检查 </td>
        </tr> 
        <tr> 
         <td> 出错了 </td> 
         <td> 11011 </td> 
         <td> LotteryID解析失败 </td> 
         <td> 对自定义页面时调jsapi参数校验出错，请检查 </td>
        </tr> 
        <tr> 
         <td> 出错了 </td> 
         <td> 11012 </td> 
         <td> 签名校验失败 </td> 
         <td> 对自定义页面时调jsapi参数校验出错，请检查 </td>
        </tr> 
        <tr> 
         <td> 出错了 </td> 
         <td> 11013 </td> 
         <td> openid无效 </td> 
         <td> 对自定义页面时调jsapi参数校验出错，请检查 </td>
        </tr> 
        <tr> 
         <td> 出错了 </td> 
         <td> 11014 </td> 
         <td> pass_ticket无效 </td> 
         <td> 检查是不是从微信摇一摇进入 </td>
        </tr> 
        <tr> 
         <td> 出错了 </td> 
         <td> 12013 </td> 
         <td> 绑定用户和红包失败 </td> 
         <td> 抽到红包ticket后，微信支付返回的错误 </td>
        </tr> 
        <tr> 
         <td> 出错了 </td> 
         <td> 12014 </td> 
         <td> 微信支付查询红包ticket失败 </td> 
         <td> 抽到红包ticket后，微信支付返回的错误 </td>
        </tr> 
        <tr> 
         <td> 出错了 </td> 
         <td> 12015 </td> 
         <td> 抽奖操作频率过高 </td> 
         <td> 请重试 </td>
        </tr> 
        <tr> 
         <td> 出错了 </td> 
         <td> 12019 </td> 
         <td> page_id无效 </td> 
         <td> 使用模版时校验出错 </td>
        </tr> 
       </tbody>
      </table> 
      <h3> <span class="mw-headline" id=".E7.BA.A2.E5.8C.85.E7.BB.91.E5.AE.9A.E7.94.A8.E6.88.B7.E4.BA.8B.E4.BB.B6.E9.80.9A.E7.9F.A5"><b>红包绑定用户事件通知</b></span></h3> 
      <p><b>接口说明</b> </p>
      <p>用户进入红包页面时，后台会将一个红包ticket和用户openid绑定，微信会把这个事件推送到开发者填写的URL（登录公众平台进入开发者中心设置）。推送内容包含用户openid，红包活动id，红包ticket、金额以及红包绑定时间。 </p> 
      <pre>注：红包绑定用户不等同于用户领取红包。用户进入红包页面后，有可能不拆红包，但该红包ticket已被绑定，不能再被其他用户绑定，过期后会退回商户财付通账户。
</pre> 
      <p><b>推送XML数据包示例</b> </p> 
      <pre>&lt;xml&gt; 	
&lt;ToUserName&gt;&lt;![CDATA[toUser]]&gt;&lt;/ToUserName&gt; 	
&lt;FromUserName&gt;&lt;![CDATA[fromUser]]&gt;&lt;/FromUserName&gt; 
&lt;CreateTime&gt;1442824314&lt;/CreateTime&gt; 
&lt;MsgType&gt;&lt;![CDATA[event]]&gt;&lt;/MsgType&gt; 	
&lt;Event&gt;&lt;![CDATA[ShakearoundLotteryBind]]&gt;&lt;/Event&gt; 	
&lt;LotteryId&gt;&lt;![CDATA[lotteryid]]&gt;&lt;/LotteryId&gt; 	
&lt;Ticket&gt;&lt;![CDATA[ticket]]&gt;&lt;/Ticket&gt; 	
&lt;Money&gt;88&lt;/Money&gt; 	
&lt;BindTime&gt;1442824313&lt;/BindTime&gt; 
&lt;/xml&gt;  
</pre> 
      <p><br> <b>调用参数说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="2" align="center" width="640px"> 
       <tbody>
        <tr> 
         <th style="width:320px">字段 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td> ToUserName </td> 
         <td> 开发者微信号。 </td>
        </tr> 
        <tr> 
         <td> FromUserName </td> 
         <td> 红包绑定用户（一个OpenID）。 </td>
        </tr> 
        <tr> 
         <td> CreateTime </td> 
         <td> 消息创建时间 （整型）。 </td>
        </tr> 
        <tr> 
         <td> MsgType </td> 
         <td> 消息类型，event </td>
        </tr> 
        <tr> 
         <td> Event </td> 
         <td> 事件类型，ShakearoundLotteryBind </td>
        </tr> 
        <tr> 
         <td> LotteryId </td> 
         <td> 红包活动id </td>
        </tr> 
        <tr> 
         <td> ticket </td> 
         <td> 红包ticket </td>
        </tr> 
        <tr> 
         <td> money </td> 
         <td> 红包金额 </td>
        </tr> 
        <tr> 
         <td> BindTime </td> 
         <td> 红包绑定时间 </td>
        </tr> 
       </tbody>
      </table> 
      <h3> <span class="mw-headline" id=".E7.BA.A2.E5.8C.85.E6.9F.A5.E8.AF.A2.E6.8E.A5.E5.8F.A3"><b>红包查询接口</b></span></h3> 
      <p><b>接口说明</b> </p>
      <p>查询红包活动信息。 </p>
      <p><b>接口调用说明</b> </p> 
      <pre>服务器端调用
http请求方式: Get
URL:<a href="https://api.weixin.qq.com/shakearound/lottery/querylottery?access_token=ACCESSTOKEN&amp;lottery_id=LOTTERYID" class="external free" rel="nofollow">https://api.weixin.qq.com/shakearound/lottery/querylottery?access_token=ACCESSTOKEN&amp;lottery_id=LOTTERYID</a>
</pre> 
      <p><br> <b>请求参数说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="3" align="center" width="640px"> 
       <tbody>
        <tr> 
         <th style="width:200px">参数 </th> 
         <th>类型 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td> access_token </td> 
         <td> string </td> 
         <td> accesstoken,以参数的形式拼装在url后 </td>
        </tr> 
        <tr> 
         <td> lottery_id </td> 
         <td> string </td> 
         <td> 红包抽奖id，来自addlotteryinfo返回的lottery_id </td>
        </tr> 
       </tbody>
      </table> 
      <p><b>返回数据说明</b> </p> 
      <table border="1" cellspacing="0" cellpadding="3" align="center" width="640px"> 
       <tbody>
        <tr> 
         <th style="width:200px">参数 </th> 
         <th>类型 </th> 
         <th>说明 </th>
        </tr> 
        <tr> 
         <td> errcode </td> 
         <td> int </td> 
         <td> 错误码。0为成功，其他为失败。详细请参考错误码表 </td>
        </tr> 
        <tr> 
         <td> errmsg </td> 
         <td> string </td> 
         <td> 错误信息 </td>
        </tr> 
        <tr> 
         <td> title </td> 
         <td> string </td> 
         <td> 抽奖活动名称（选择使用模板时，也作为摇一摇消息主标题），最长6个汉字，12个英文字母。 </td>
        </tr> 
        <tr> 
         <td> desc </td> 
         <td> string </td> 
         <td> 抽奖活动描述（选择使用模板时，也作为摇一摇消息副标题），最长7个汉字，14个英文字母。 </td>
        </tr> 
        <tr> 
         <td> onoff </td> 
         <td> int </td> 
         <td> 抽奖开关。0关闭，1开启，默认为1 </td>
        </tr> 
        <tr> 
         <td> begin_time </td> 
         <td> long </td> 
         <td> 抽奖活动开始时间，unix时间戳，单位秒 </td>
        </tr> 
        <tr> 
         <td> expire_time </td> 
         <td> long </td> 
         <td> 抽奖活动结束时间，unix时间戳，单位秒，红包活动有效期最长为91天 </td>
        </tr> 
        <tr> 
         <td> sponsor_appid </td> 
         <td> string </td> 
         <td> 红包提供商户公众号的appid </td>
        </tr> 
        <tr> 
         <td> appid </td> 
         <td> string </td> 
         <td> 创建活动的开发者appid </td>
        </tr> 
        <tr> 
         <td> prize_count </td> 
         <td> long </td> 
         <td> 已录入的红包总数 </td>
        </tr> 
        <tr> 
         <td> prize_count_limit </td> 
         <td> long </td> 
         <td> 创建活动时预设的录入红包ticket数量上限 </td>
        </tr> 
        <tr> 
         <td> jump_url </td> 
         <td> string </td> 
         <td> 红包关注界面后可以跳转到第三方自定义的页面 </td>
        </tr> 
        <tr> 
         <td> expired_prizes </td> 
         <td> long </td> 
         <td> 过期红包ticket数量 </td>
        </tr> 
        <tr> 
         <td> drawed_prizes </td> 
         <td> long </td> 
         <td> 已发放的红包ticket数量 </td>
        </tr> 
        <tr> 
         <td> available_prizes </td> 
         <td> long </td> 
         <td> 可用的红包ticket数量 </td>
        </tr> 
        <tr> 
         <td> expired_value </td> 
         <td> long </td> 
         <td> 已过期的红包金额总和 </td>
        </tr> 
        <tr> 
         <td> drawed_value </td> 
         <td> long </td> 
         <td> 已发放的红包金额总和 </td>
        </tr> 
        <tr> 
         <td> available_value </td> 
         <td> long </td> 
         <td> 可用的红包金额总和 </td>
        </tr> 
       </tbody>
      </table> 
      <pre> 注意：调用SetPrizeBucket录入红包次数超过3000次的，或红包总数超过1万个的活动，目前暂不支持expired_prizes, drawed_prizes, available_prizes, expired_value, drawed_value, available_value这6个字段的查询。需要查询时，可以通过邮箱zhoubian@tencent.com联系我们，也可加入开发者QQ交流群390582489。
</pre> 
      <p><b>示例</b> </p> 
      <pre>{     	
"errcode":0,    		
"errmsg":""
result:{
    lottery_id:” 9sQqUrmdFaY6v9z8TartOA”,
    title:”活动标题”,
    desc:”活动描述”,
    onoff:”1”,
    begin_time:” 1446360417”,
    expire_time:” 1446400000”,
    sponsor_appid:” wxf5b5e87a6a0fde94”,
    appid:”wx4428b5f51c53a582”,
    prize_count_limit:1000,
    prize_count: 810,
    jump_url:”<a href="http://www.qq.com/”" class="external free" rel="nofollow">http://www.qq.com/”</a>,
    expired_prizes: 100,
    drawed_prizes:200,
    available_prizes:510,
    expired_value: 10000,
    drawed_value:20000,
    available_value: 51000
    }  
}
</pre> 
      <!-- 
NewPP limit report
Preprocessor node count: 30/1000000
Post-expand include size: 0/2097152 bytes
Template argument size: 0/2097152 bytes
Expensive parser function count: 0/100
--> 
      <div class="printfooter">
        取自“
       <a href="../7/0ddd50ed2421b99fedd071281c074aab.html">../7/0ddd50ed2421b99fedd071281c074aab.html</a>”
      </div> 
      <!-- /bodytext --> 
      <!-- catlinks --> 
      <div id="catlinks" class="catlinks catlinks-allhidden"></div> 
      <!-- /catlinks --> 
      <div class="visualClear"></div> 
     </div> 
     <!-- /bodyContent --> 
    </div> 
    <!-- /content --> 
   </div> 
  </div> 
  <!-- footer --> 
  <div class="foot" id="footer"> 
   <ul class="links ft" id="footer-places"> 
    <li class="links_item no_extra" id="footer-about"><a target="_blank" href="http://www.tencent.com/zh-cn/index.shtml">关于腾讯</a></li> 
    <li class="links_item" id="footer-policy"> <a target="_blank" href="#">服务协议</a></li> 
    <li class="links_item" id="footer-contactus"><a target="_blank" href="http://kf.qq.com/special_auto/weixin.html">客服中心</a></li> 
    <li class="links_item" id="footer-contactus"><a href="http://crm2.qq.com/page/portalpage/wpa.php?uin=40012345&amp;f=1&amp;ty=1&amp;ap=000011:400792:|f:Ggzpt1" target="_blank">在线客服</a></li> 
   </ul> 
   <ul id="footer-icons" class="noprint"> 
    <li id="footer-poweredbyico"> <a href="http://www.mediawiki.org/"><img src="../static/assets/1360f2593ddc8c336d455df43678bb00.png" alt="Powered by MediaWiki" width="88" height="31"></a> </li> 
   </ul> 
   <p class="copyright">Copyright&nbsp;© 2012-2016 Tencent. All Rights Reserved.</p> 
  </div> 
  <!-- /footer --> 
  <script src="../static/8de4f51dbc81a02504e69db45b414107.css"></script> 
  <script>if ( window.mediaWiki ) {
	mediaWiki.config.set({"wgCanonicalNamespace": "", "wgCanonicalSpecialPageName": false, "wgNamespaceNumber": 0, "wgPageName": "摇一摇红包", "wgTitle": "摇一摇红包", "wgAction": "view", "wgArticleId": 240, "wgIsArticle": true, "wgUserName": null, "wgUserGroups": ["*"], "wgCurRevisionId": 3261, "wgCategories": [], "wgBreakFrames": false, "wgRestrictionEdit": [], "wgRestrictionMove": []});
}
</script> 
  <script>if ( window.mediaWiki ) {
	mediaWiki.loader.load(["mediawiki.util", "mediawiki.legacy.wikibits", "mediawiki.legacy.ajax"]);
	mediaWiki.loader.go();
}
</script> 
  <script>if ( window.mediaWiki ) {
	mediaWiki.user.options.set({"ccmeonemails":0,"cols":80,"contextchars":50,"contextlines":5,"date":"default","diffonly":0,"disablemail":0,"disablesuggest":0,"editfont":"default","editondblclick":0,"editsection":1,"editsectiononrightclick":0,"enotifminoredits":0,"enotifrevealaddr":0,"enotifusertalkpages":1,"enotifwatchlistpages":0,"extendwatchlist":0,"externaldiff":0,"externaleditor":0,"fancysig":0,"forceeditsummary":0,"gender":"unknown","hideminor":0,"hidepatrolled":0,"highlightbroken":1,"imagesize":2,"justify":0,"math":1,"minordefault":0,"newpageshidepatrolled":0,"nocache":0,"noconvertlink":0,"norollbackdiff":0,"numberheadings":0,"previewonfirst":0,"previewontop":1,"quickbar":1,"rcdays":7,"rclimit":50,"rememberpassword":0,"rows":25,"searchlimit":20,"showhiddencats":0,"showjumplinks":1,"shownumberswatching":1,"showtoc":1,"showtoolbar":1,"skin":"vector","stubthreshold":0,"thumbsize":2,"underline":2,"uselivepreview":0,"usenewrc":0,"watchcreations":0,"watchdefault":0,"watchdeletion":0,
	"watchlistdays":3,"watchlisthideanons":0,"watchlisthidebots":0,"watchlisthideliu":0,"watchlisthideminor":0,"watchlisthideown":0,"watchlisthidepatrolled":0,"watchmoves":0,"wllimit":250,"variant":"zh-cn","language":"zh-cn","searchNs0":true,"searchNs1":false,"searchNs2":false,"searchNs3":false,"searchNs4":false,"searchNs5":false,"searchNs6":false,"searchNs7":false,"searchNs8":false,"searchNs9":false,"searchNs10":false,"searchNs11":false,"searchNs12":false,"searchNs13":false,"searchNs14":false,"searchNs15":false});;mediaWiki.loader.state({"user.options":"ready"});
}
</script> 
  <!-- fixalpha --> 
  <script type="text/javascript"> if ( window.isMSIE55 ) fixalpha(); </script> 
  <!-- /fixalpha --> 
  <!-- Served in 0.223 secs. --> 
  <script type="text/javascript">
		// @cunjinli
		setTimeout(function() {
			$("#mw-panel .portal .body li a").each(function() {
				var href = $(this).attr("href"),
				    idx = href.lastIndexOf("/");
				if (!/\.html$/.test(href)) return;

				if (idx>=0) href = href.substr(idx+1);
				var r = new RegExp(href+"$");
				if (r.test(location.href)) {
				    $(this).closest(".portal").find("h5").click();
				    return false;
				}
			});
		}, 100);
		</script>   
  <!-- Welcome to ask gy-team -->
  <!-- so -->
 </body>
</html>